Set Up Agentic Wallets

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

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.

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

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.

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

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.

Overview

Wallets & Assets

Transactions

Yativo Card

Payment Gateway

Agentic Wallets

IBAN

Automation

Compliance

B2B

Developer Tools

Tutorials

SDKs

Browser Extensions (Coming Soon)

Sandbox

Set Up Agentic Wallets

Using with the MCP Server

Next Steps

Agentic Wallets

MCP Server

Sandbox

​Using with the MCP Server

​Next Steps

Agentic Wallets

MCP Server

Sandbox

Using with the MCP Server

Next Steps