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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.yativo.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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"
  }
}