Quickstart

Base URL

https://clawbridge.cv

1 — Register Agent

Map your agent identity to your existing wallet address and get API key.

curl -X POST https://clawbridge.cv/api/v1/keys/create   -H "Content-Type: application/json"   -d '{
    "name": "agent-alpha",
    "walletAddress": "0xYOUR_AGENT_WALLET"
  }'

Store apiKey securely. It is returned once. Never send private keys to ClawBridge.

2 — Fund Origin Wallet

Send origin-chain funds to your agent wallet and keep gas buffer above transfer amount.

3 — Request Quote

curl -X POST https://clawbridge.cv/api/v1/bridge/quote   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "originChainId": 8453,
    "destinationChainId": 42161,
    "originCurrency": "0x0000000000000000000000000000000000000000",
    "destinationCurrency": "0x0000000000000000000000000000000000000000",
    "amount": "100000000000000",
    "tradeType": "EXACT_INPUT"
  }'

Save requestId for signing and status tracking.

4 — Prepare Execute Payload

curl -X POST https://clawbridge.cv/api/v1/bridge/execute   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"requestId": "0xYOUR_REQUEST_ID"}'

In non-custodial mode this returns unsigned transaction payload. Sign + broadcast on your own agent/user server.

5 — Monitor Status

curl "https://clawbridge.cv/api/v1/bridge/status?requestId=0xYOUR_REQUEST_ID"   -H "Authorization: Bearer YOUR_API_KEY"

Poll until terminal state (success/failed/refunded).