aibank
API ReferenceTransfers

Bridge Tokens

Move tokens between chains using a cross-chain bridge.

Bridge Tokens

Transfer tokens from one blockchain to another using a cross-chain bridge.

Authentication

Requires X-API-Key header.

Path parameters

ParameterTypeDescription
idstringWallet UUID

Request body

Both camelCase and snake_case parameter names are accepted.

Request

curl -X POST http://localhost:4000/v1/wallets/WALLET_ID/bridge \
  -H "X-API-Key: ak_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceChain": "ethereum",
    "destinationChain": "base",
    "token": "USDC",
    "amount": "50.00"
  }'

Response (200)

{
  "transaction_id": "tx-uuid",
  "tx_hash": "0xabc123...",
  "source_chain": "ethereum",
  "destination_chain": "base",
  "token": "USDC",
  "amount": "50.00",
  "status": "confirmed"
}

Errors

StatusCodeDescription
400INVALID_INPUTMissing or invalid fields
404NOT_FOUNDWallet not found
500BRIDGE_FAILEDBridge execution failed

On this page