Skip to main content

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.

This guide walks you through creating an agentic wallet, generating a connector API key, and making your first agent-initiated payment.
1

Create a wallet

curl -X POST 'https://crypto-api.yativo.com/api/v1/agentic-wallets/create' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "My AI Agent Wallet" }'
Response
{
  "success": true,
  "data": {
    "wallet_id": "aw_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "name": "My AI Agent Wallet",
    "status": "pending_activation",
    "created_at": "2026-03-25T10:00:00Z"
  }
}
Save the wallet_id from the response.
2

Activate the wallet

Request an activation OTP:
curl -X POST 'https://crypto-api.yativo.com/api/v1/agentic-wallets/aw_.../activation/send-email-otp' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
Response
{
  "success": true,
  "message": "OTP sent to your registered email"
}
Enter the OTP from your email to activate:
curl -X POST 'https://crypto-api.yativo.com/api/v1/agentic-wallets/aw_.../activation/activate' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "email_otp": "123456" }'
Response
{
  "success": true,
  "data": {
    "wallet_id": "aw_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "status": "active",
    "address": "0x9F8b2E...a4C7",
    "chain": "solana",
    "activated_at": "2026-03-25T10:05:00Z"
  }
}
3

Add a connector

Create an API key for your agent:
curl -X POST 'https://crypto-api.yativo.com/api/v1/agentic-wallets/aw_.../connectors' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Production Agent",
    "per_transaction_limit": 50,
    "daily_limit": 500,
    "monthly_limit": 5000
  }'
Response
{
  "success": true,
  "data": {
    "connector_id": "conn_01HX9KZMB3F7VNQP8R2WDGT",
    "name": "Production Agent",
    "api_key": "yac_e072b3ef7e30fcb420183aa86ddd8452",
    "per_transaction_limit": 50,
    "daily_limit": 500,
    "monthly_limit": 5000,
    "created_at": "2026-03-25T10:10:00Z"
  }
}
Save the api_key (starts with yac_) — it’s shown only once.
4

Fund the wallet

Deposit USDC to the wallet’s on-chain address, or use manual funding:
curl -X POST 'https://crypto-api.yativo.com/api/v1/agentic-wallets/aw_.../fund' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "amount": 100 }'
Response
{
  "success": true,
  "data": {
    "wallet_id": "aw_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "funded_amount": 100,
    "balance": 100,
    "currency": "USDC"
  }
}
5

Make your first agent payment

Using the connector API key, send a payment:
curl -X POST 'https://crypto-api.yativo.com/api/v1/agent/transact' \
  -H 'Authorization: Bearer yac_your_connector_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "wallet_id": "aw_...",
    "amount": 5.00,
    "recipient_address": "0x9F8b...",
    "service_name": "OpenAI",
    "payment_reason": "GPT-4 inference"
  }'
Response
{
  "success": true,
  "data": {
    "transaction_id": "atx_01HX9KZMB3F7VNQP8R2WDGT",
    "wallet_id": "aw_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "amount": 5.00,
    "recipient_address": "0x9F8b...",
    "service_name": "OpenAI",
    "status": "confirmed",
    "tx_hash": "0xabc123...",
    "created_at": "2026-03-25T10:15:00Z"
  }
}

​
Using with the MCP Server

For AI agents that support the Model Context Protocol, skip the API calls and use the MCP server: 
npm install -g @yativo/mcp-server
Then configure it in your AI client (e.g., Claude Desktop): 
{
  "mcpServers": {
    "yativo-wallet": {
      "command": "npx",
      "args": ["-y", "@yativo/mcp-server"],
      "env": {
        "YATIVO_API_KEY": "yac_your_connector_key",
        "YATIVO_WALLET_ID": "aw_your_wallet_id"
      }
    }
  }
}
Your agent can now say “check my balance” or “send $5 to 0x…” and it works.

​
Next Steps

Agentic Wallets

Full Agentic Wallets documentation.

MCP Server

MCP server setup and tool reference.

Sandbox

Test in sandbox first.