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 '{
    "connector_type": "anthropic",
    "name": "Production Agent",
    "max_per_transaction": 50,
    "max_daily_amount": 500,
    "max_monthly_amount": 5000,
    "allowed_capabilities": ["transfer"]
  }'

Response

{
  "success": true,
  "data": {
    "connector_id": "6650c3d4e5f6a7b8c9d0e1f2",
    "connector_type": "anthropic",
    "name": "Production Agent",
    "api_key": "yac_e072b3ef7e30fcb420183aa86ddd8452",
    "max_per_transaction": 50,
    "max_daily_amount": 500,
    "max_monthly_amount": 5000,
    "allowed_capabilities": ["transfer"]
  }
}

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

Overview

Wallets & Assets

Transactions

Yativo Card

Payment Gateway

Agentic Wallets

Automation

Compliance

B2B

Developer Tools

Tutorials

Sandbox

Set Up Agentic Wallets

Next Steps

Agentic Wallets

Sandbox

​Next Steps

Agentic Wallets

Sandbox

Next Steps