> ## 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.

# Set Up Agentic Wallets

> Create a programmable wallet for your AI agent in under 10 minutes

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

***

<Steps>
  <Step title="Create a wallet">
    ```bash theme={null}
    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" }'
    ```

    ```json Response theme={null}
    {
      "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.
  </Step>

  <Step title="Activate the wallet">
    Request an activation OTP:

    ```bash theme={null}
    curl -X POST 'https://crypto-api.yativo.com/api/v1/agentic-wallets/aw_.../activation/send-email-otp' \
      -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
    ```

    ```json Response theme={null}
    {
      "success": true,
      "message": "OTP sent to your registered email"
    }
    ```

    Enter the OTP from your email to activate:

    ```bash theme={null}
    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" }'
    ```

    ```json Response theme={null}
    {
      "success": true,
      "data": {
        "wallet_id": "aw_01HX9KZMB3F7VNQP8R2WDGT4E5",
        "status": "active",
        "address": "0x9F8b2E...a4C7",
        "chain": "solana",
        "activated_at": "2026-03-25T10:05:00Z"
      }
    }
    ```
  </Step>

  <Step title="Add a connector">
    Create an API key for your agent:

    ```bash theme={null}
    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"]
      }'
    ```

    ```json Response theme={null}
    {
      "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.
  </Step>

  <Step title="Fund the wallet">
    Deposit USDC to the wallet's on-chain address, or use manual funding:

    ```bash theme={null}
    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 }'
    ```

    ```json Response theme={null}
    {
      "success": true,
      "data": {
        "wallet_id": "aw_01HX9KZMB3F7VNQP8R2WDGT4E5",
        "funded_amount": 100,
        "balance": 100,
        "currency": "USDC"
      }
    }
    ```
  </Step>

  <Step title="Make your first agent payment">
    Using the connector API key, send a payment:

    ```bash theme={null}
    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"
      }'
    ```

    ```json Response theme={null}
    {
      "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"
      }
    }
    ```
  </Step>
</Steps>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Agentic Wallets" icon="robot" href="/yativo-crypto/agentic-wallets">
    Full Agentic Wallets documentation.
  </Card>

  <Card title="Sandbox" icon="flask" href="/sandbox/agentic-wallets">
    Test in sandbox first.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.