Skip to main content
POST
/
v1
/
agent
/
transact
curl -X POST '/v1/agent/transact' \
  -H 'Authorization: Bearer yac_connector_api_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "wallet_id": "aw_01abc123",
    "amount": 5.00,
    "asset": "USDC",
    "recipient_address": "0x9F8b3A2c1E4D7F6B5A4C3D2E1F0A9B8C7D6E5F4",
    "service_name": "OpenAI API",
    "service_url": "https://api.openai.com",
    "payment_reason": "GPT-4 inference for customer support bot",
    "payment_category": "ai_service"
  }'
{
  "success": true,
  "data": {
    "transaction_id": "atx_01pqr456",
    "tx_hash": "0xabc123def456...",
    "amount": 5.00,
    "asset": "USDC",
    "recipient_address": "0x9F8b3A2c1E4D7F6B5A4C3D2E1F0A9B8C7D6E5F4",
    "chain": "base",
    "status": "completed",
    "fee": 0.00,
    "is_free_transaction": true,
    "service_name": "OpenAI API",
    "payment_category": "ai_service"
  }
}
Authorization
string
required
Connector API key: Bearer yac_...
wallet_id
string
required
The agentic wallet ID to send from.
amount
number
required
Amount in USD to send.
asset
string
Asset to send. Defaults to USDC.
chain
string
Chain override (e.g., base, ethereum, solana).
recipient_address
string
required
The destination wallet address.
service_name
string
required
Name of the service being paid (for audit trail).
service_url
string
URL of the service being paid.
payment_reason
string
required
Why this payment is being made (for audit trail).
payment_category
string
Category: ai_service, prediction_market, legal_escrow, subscription, purchase, transfer, settlement, other. Defaults to other.
curl -X POST '/v1/agent/transact' \
  -H 'Authorization: Bearer yac_connector_api_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "wallet_id": "aw_01abc123",
    "amount": 5.00,
    "asset": "USDC",
    "recipient_address": "0x9F8b3A2c1E4D7F6B5A4C3D2E1F0A9B8C7D6E5F4",
    "service_name": "OpenAI API",
    "service_url": "https://api.openai.com",
    "payment_reason": "GPT-4 inference for customer support bot",
    "payment_category": "ai_service"
  }'
{
  "success": true,
  "data": {
    "transaction_id": "atx_01pqr456",
    "tx_hash": "0xabc123def456...",
    "amount": 5.00,
    "asset": "USDC",
    "recipient_address": "0x9F8b3A2c1E4D7F6B5A4C3D2E1F0A9B8C7D6E5F4",
    "chain": "base",
    "status": "completed",
    "fee": 0.00,
    "is_free_transaction": true,
    "service_name": "OpenAI API",
    "payment_category": "ai_service"
  }
}