/balances

List balances

Requires API-key authentication (agentAuth, agentId).

Purpose: list balances for the authenticated agent wallet.

Auth and scope: header-key auth or OAuth agent:read.

Idempotency: not required.

Query:

{
  "cursor": "string, optional",
  "limit": 50
}

Response:

{
  "ok": true,
  "items": [
    {
      "asset_symbol": "USDC",
      "asset_display_name": "USD Coin",
      "amount": "1",
      "amount_usd": "1",
      "category": "cash"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

amount is a decimal asset-unit string. For USDC, "1" means 1 USDC.

Common errors: authentication_failed, insufficient_scope, rate_limited.

Related recipe: Quickstart.