Sign in
latestOpenAPI 3.0.32026-08-20146131.7 MB

672b1916ba61

Wallets

Aggregate wallet balances

Aggregates tracked balances for active wallets under the same owner-aware inclusion rules as the wallet list, without exposing one aggregate-level owner or runtime-admission value.

get/v1/wallets/aggregate

Query parameters

provider'local' | 'fireblocks' | 'privy' | 'coinbase_cdp' | 'para' | 'turnkey' | 'dfns' | 'ibm_haven' | 'anchorage'

Wallet signing provider.

Example:privy

Wallet signing provider.

includeAllProvidersboolean

Headers

x-project-idstring

Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

Example:prj_example

Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

Response

Aggregated wallet balances

Example response

{
  "data": {
    "aggregate": {
      "walletCount": 3,
      "balances": [
        {
          "token": "USDC",
          "mint": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
          "amount": "1250000",
          "uiAmount": "1.25",
          "decimals": 6,
          "usdPrice": 1,
          "usdValue": 125.5
        }
      ]
    }
  },
  "meta": {
    "requestId": "req_example",
    "timestamp": "2025-01-01T00:00:00.000Z"
  }
}