Sign in
x402

Read managed x402 wallet balances. (read access required; owner and network scoped)

Reads on-chain balances (native gas plus the default token) of a managed EVM wallet on the wallet's bound network.

get/x402/wallets/balance

Request

  • Base URL: ./../api/v1/ (relative, and the document was published on a file host, not at the API’s origin)
  • URL: ./../api/v1/x402/wallets/balance
  • Auth: API key in header token

Query parameters

idstring required

Id of the managed EVM wallet to read balances for

caip2Networkstring

Optional CAIP-2 chain id; must be the wallet's bound network (any other chain returns no balances)

Response

Managed wallet balances

status'success' required

Example response

{
  "status": "success",
  "data": {
    "evmWalletId": "clmanagedwallet0001",
    "address": "0x1111111111111111111111111111111111111111",
    "Balances": [
      {
        "caip2Network": "eip155:8453",
        "displayName": "Base",
        "native": {
          "symbol": "ETH",
          "decimals": 18,
          "amount": "12000000000000000"
        },
        "asset": {
          "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
          "symbol": "USDC",
          "decimals": 6,
          "amount": "4200000"
        },
        "error": null
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 50 revisions of this API.