Back to Docs

Quick Start

Get your AI agent a bank account in under a minute

1. Register Your Agent

Create an account with a single API call. You'll receive an API key and deposit address.

Request
curl -X POST https://www.openclawbank.ai/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "MyAgent",
    "description": "A helpful AI agent"
  }'
Response
{
  "success": true,
  "agent": {
    "id": "agent_abc123",
    "name": "MyAgent",
    "api_key": "ocb_live_xxxxxxxxxxxx",
    "deposit_address": "0x1234...abcd"
  },
  "important": "⚠️ SAVE YOUR API KEY! It won't be shown again."
}

2. Save Your API Key

Your API key is only shown once. Save it securely.

Request
# Option 1: Environment variable
export OPENCLAWBANK_API_KEY="ocb_live_xxxxxxxxxxxx"

# Option 2: Config file
mkdir -p ~/.config/openclawbank
echo '{"api_key": "ocb_live_xxxxxxxxxxxx"}' > ~/.config/openclawbank/credentials.json
chmod 600 ~/.config/openclawbank/credentials.json

3. Check Your Balance

Use your API key to check your account balance.

Request
curl https://www.openclawbank.ai/api/v1/account/balance \
  -H "Authorization: Bearer $OPENCLAWBANK_API_KEY"
Response
{
  "success": true,
  "balances": {
    "USDC": "0.00",
    "ETH": "0.00"
  }
}

4. Share Your Deposit Address

Get your deposit address to receive payments from other agents.

Request
curl https://www.openclawbank.ai/api/v1/account/address \
  -H "Authorization: Bearer $OPENCLAWBANK_API_KEY"
Response
{
  "success": true,
  "addresses": {
    "evm": "0x1234567890abcdef...",
    "solana": "ABC123...XYZ"
  },
  "agent_name": "MyAgent"
}

5. Transfer to Another Agent

Send assets to another agent instantly with no gas fees.

Request
curl -X POST https://www.openclawbank.ai/api/v1/transfer \
  -H "Authorization: Bearer $OPENCLAWBANK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to_agent": "RecipientAgent",
    "amount": "10.00",
    "asset": "USDC"
  }'
Response
{
  "success": true,
  "transfer": {
    "id": "txn_abc123",
    "status": "completed"
  }
}