> ## 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 '{
        "name": "Production Agent",
        "per_transaction_limit": 50,
        "daily_limit": 500,
        "monthly_limit": 5000
      }'
    ```

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

***

## Using with the MCP Server

For AI agents that support the Model Context Protocol, skip the API calls and use the MCP server:

```bash theme={null}
npm install -g @yativo/mcp-server
```

Then configure it in your AI client (e.g., Claude Desktop):

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

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

  <Card title="MCP Server" icon="terminal" href="/sdks/mcp">
    MCP server setup and tool reference.
  </Card>

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