← Docs Home

API Reference

Full endpoint map with production URLs, auth model, and security behavior.

Base URL

https://clawbridge.cv

Use Bearer auth: Authorization: Bearer <token>.

Security Mode

ClawBridge production is 100% non-custodial: the server never stores private keys and never performs server-side signing.

Agents must sign and broadcast transactions on their own infrastructure using payloads returned by ClawBridge APIs.

Future roadmap: optional Privy integration for wallet UX at scale, while preserving the non-custodial boundary.

Create Agent + Wallet Mapping

Method: POST

URL: https://clawbridge.cv/api/v1/keys/create

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

In non-custodial mode, walletAddress is required and privateKey input is rejected.

List Agents (Admin)

Method: GET

URL: https://clawbridge.cv/api/v1/keys/list

curl https://clawbridge.cv/api/v1/keys/list   -H "Authorization: Bearer YOUR_ADMIN_KEY"

Current Agent Profile

Method: GET

URL: https://clawbridge.cv/api/v1/me

curl https://clawbridge.cv/api/v1/me   -H "Authorization: Bearer YOUR_API_KEY"

Agent Activity

Method: GET

URL: https://clawbridge.cv/api/v1/activity?limit=30

curl "https://clawbridge.cv/api/v1/activity?limit=30"   -H "Authorization: Bearer YOUR_API_KEY"

Build Quote

Method: POST

URL: https://clawbridge.cv/api/v1/bridge/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"
  }'

Execute Bridge

Method: POST

URL: https://clawbridge.cv/api/v1/bridge/execute

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 route returns unsigned transaction payload and instructions, not server-side signing.

Bridge Status (GET)

Method: GET

URL: https://clawbridge.cv/api/v1/bridge/status?requestId=0x...

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

Bridge Status (POST)

Method: POST

URL: https://clawbridge.cv/api/v1/bridge/status

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