Holdings

{
  "success": true,
  "data": {
    "wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
    "blockchain": "solana",
    "profile": {
      "csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
      "username": "MazeCCC",
      "name": "Maze",
      "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "twitter": "https://x.com/MazeCCC",
      "telegram": "",
      "blockchain": "solana",
      "currency": "SOL",
      "type": "csid",
      "kol": true,
      "active_hours": "",
      "profile_url": "https://id.cabalspy.xyz/u/MazeCCC"
    },
    "active_holdings": {
      "tokens": [
        {
          "token_address": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
          "token_name": "invisibull",
          "symbol": "invisibull",
          "logo": "https://...",
          "amount": "22113972030000",
          "amount_formatted": "22113972.03",
          "decimals": 6,
          "price_usd": 0.0000071,
          "value_usd": 157.009201,
          "verified_contract": null
        }
      ],
      "count": 1,
      "total_value_usd": 157.01,
      "last_updated": "2026-10-13T08:04:11Z",
      "stale": false,
      "loading": false
    }
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-13T08:04:11Z"
  }
}

{
  "success": true,
  "data": {
    "wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
    "blockchain": "solana",
    "profile": {
      "csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
      "username": "MazeCCC",
      "name": "Maze",
      "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "twitter": "https://x.com/MazeCCC",
      "telegram": "",
      "blockchain": "solana",
      "currency": "SOL",
      "type": "csid",
      "kol": true,
      "active_hours": "",
      "profile_url": "https://id.cabalspy.xyz/u/MazeCCC"
    },
    "active_holdings": {
      "tokens": [
        {
          "token_address": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
          "token_name": "invisibull",
          "symbol": "invisibull",
          "logo": "https://...",
          "amount": "22113972030000",
          "amount_formatted": "22113972.03",
          "decimals": 6,
          "price_usd": 0.0000071,
          "value_usd": 157.009201,
          "verified_contract": null
        }
      ],
      "count": 1,
      "total_value_usd": 157.01,
      "last_updated": "2026-10-13T08:04:11Z",
      "stale": false,
      "loading": false
    }
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-13T08:04:11Z"
  }
}

The current token balances of a verified wallet of your users, with price and USD value, read from the chain. Balances worth less than $0.01 are hidden. Tokens are sorted by USD value, largest first. Use it to show a portfolio on a profile page or to check what a trader you copy is holding right now.

Holdings are cached for 30 seconds. meta.cached and meta.cache_age_seconds show the age of the data.

Query Parameters

string

required

Chain of the wallet. One of solana, bnb, base, eth, rh.

string

required

A wallet verified on this chain by one of your users.

string

default:"instance"

global allows any CabalSpy ID wallet. Enterprise plan only.

string

Your Instance ID. Only needed when your account has several instances.

string

required

Your API key. Alternatively pass it as an Authorization Bearer header.

Usage Example

curl "https://api-id.cabalspy.xyz/v1/wallets/holdings?blockchain=solana&address=7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW" \
  -H "Authorization: Bearer YOUR_KEY"

import requests

params = {"blockchain": "solana", "address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW"}
r = requests.get("https://api-id.cabalspy.xyz/v1/wallets/holdings", params=params,
                 headers={"Authorization": "Bearer YOUR_KEY"})
h = r.json()["data"]["active_holdings"]
print(h["count"], "tokens worth", h["total_value_usd"], "USD")
for t in h["tokens"][:5]:
    print(t["symbol"], t["amount_formatted"], t["value_usd"])

const p = new URLSearchParams({
  blockchain: "solana",
  address: "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
});
const res = await fetch(`https://api-id.cabalspy.xyz/v1/wallets/holdings?${p}`, {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data } = await res.json();
console.log(data.active_holdings.total_value_usd, data.active_holdings.tokens);

Response

boolean

True on success.

object

Show data

string

The wallet address.

string

Chain.

object

The owner’s profile, the same fields as on the tracker.

object

Show active_holdings

array

Show token

string

Token mint or contract.

string

Token name.

string

Token symbol.

string

Token logo URL.

string

Raw balance in the token’s smallest unit.

string

Balance in whole tokens.

integer

Token decimals.

number

Token price in USD.

number

Value of the balance in USD.

boolean

Reserved, currently null.

integer

Number of tokens.

number

Total value of all tokens in USD.

string

When the balances were read.

boolean

True when the cached balances are older than 30 seconds.

boolean

Always false, kept for compatibility with the CabalSpy API.

{
  "success": true,
  "data": {
    "wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
    "blockchain": "solana",
    "profile": {
      "csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
      "username": "MazeCCC",
      "name": "Maze",
      "image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "twitter": "https://x.com/MazeCCC",
      "telegram": "",
      "blockchain": "solana",
      "currency": "SOL",
      "type": "csid",
      "kol": true,
      "active_hours": "",
      "profile_url": "https://id.cabalspy.xyz/u/MazeCCC"
    },
    "active_holdings": {
      "tokens": [
        {
          "token_address": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
          "token_name": "invisibull",
          "symbol": "invisibull",
          "logo": "https://...",
          "amount": "22113972030000",
          "amount_formatted": "22113972.03",
          "decimals": 6,
          "price_usd": 0.0000071,
          "value_usd": 157.009201,
          "verified_contract": null
        }
      ],
      "count": 1,
      "total_value_usd": 157.01,
      "last_updated": "2026-10-13T08:04:11Z",
      "stale": false,
      "loading": false
    }
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "v1",
    "timestamp": "2026-10-13T08:04:11Z"
  }
}

Errors

Status	Code	Meaning
400	missing_parameter	blockchain or address is missing.
400	invalid_parameter	blockchain or address invalid.
401	missing_api_key	API key missing.
403	invalid_api_key	API key invalid or not enabled for CabalSpy ID.
403	scope_not_allowed	scope=global needs the Enterprise plan.
404	wallet_not_found	The wallet is not verified on this chain by one of your users.
429	rate_limit_exceeded	Rate limit exceeded.
503	service_unavailable	Holdings are temporarily unavailable, retry shortly.

Introduction

Login

Data API

Users

Trading

Theses

Streams

Reference

Query Parameters

Usage Example

Response

Errors

​Query Parameters

​Usage Example

​Response

​Errors

Query Parameters

Usage Example

Response

Errors