Wallet Holdings

Returns a tracked wallet's CURRENT on-chain token balances — the tokens the wallet actually holds right now, read live from the blockchain. This is period-independent: it always reflects the present state, regardless of any time window. Tokens that were fully sold no longer appear (their on-chain balance is zero). Quantities only — no USD or native values.

Get a wallet's current on-chain holdings

get

Returns the wallet's current token balances, sorted by quantity with the chain's native coin (SOL / ETH / BNB) pinned first. Spam tokens and clearly irrelevant dust are filtered out; a maximum of 100 tokens is returned.

Why this is a separate endpoint — holdings are read live from the blockchain via an on-chain data provider. The first lookup for a wallet can take a few seconds, so it is kept out of the fast GET /v1/wallet/tracking response. Results are cached per wallet and refreshed at most once every 10 minutes, so repeat calls within that window return instantly.

Recommended usage — call GET /v1/wallet/tracking first to render the trading profile immediately, then call this endpoint separately (e.g. when the user opens the "Holdings" tab) to load the balances. If the cache is still warming up, the response returns loading: true with an empty tokens array — simply call again a second or two later to get the populated result.

Parameters

• blockchain (required) — one of: solana, bnb, base, eth

• address (required) — wallet address (Solana base58 or 0x… for EVM chains)

• api_key (optional if Bearer header is used)

Authorizations

bearerAuthapiKeyQuery

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Query parameters

blockchainstring · enumRequiredExample: solanaPossible values:

addressstringRequiredExample: G6fUXjMKPJzCY1rveAE6Qm7wy5U3vZgKDJmN1VPAdiZC

api_keystringOptionalExample: YOUR_KEY

Responses

200

Holdings returned. If the cache is still warming up, loading is true and tokens is empty — call again shortly.

application/json

successbooleanOptional

metaobjectOptional

400

Missing or invalid parameter.

application/json

401

Missing API key.

application/json

403

Invalid or exhausted API key.

application/json

404

Wallet not tracked on this chain.

application/json

429

Rate limit exceeded.

application/json

get

/v1/wallet/holdings

HTTPcURLJavaScriptPython

GET /v1/wallet/holdings?blockchain=solana&address=text HTTP/1.1
Host: api.cabalspy.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": {
    "active_holdings": {
      "tokens": [
        {
          "token_address": "So11111111111111111111111111111111111111112",
          "token_name": "Solana",
          "symbol": "SOL",
          "amount": "12500000000",
          "amount_formatted": "12.5",
          "decimals": 9,
          "verified_contract": true,
          "possible_spam": false
        },
        {
          "token_address": "9n4nbM75f5Ui33ZbPYXn59EwSgE8CGsHtAeTH5YFeJ9A",
          "token_name": "dogwifhat",
          "symbol": "WIF",
          "amount": "4200000000",
          "amount_formatted": "4200.0",
          "decimals": 6,
          "verified_contract": true,
          "possible_spam": false
        }
      ],
      "count": 2,
      "last_updated": 1742394120,
      "stale": false,
      "loading": false
    }
  },
  "meta": {
    "request_id": "req_a1b2c3d4e5f6",
    "cached": true,
    "version": "1.0.0",
    "timestamp": "2025-03-19T14:22:30Z"
  }
}