Skip to main content
GET
Holdings
Return a wallet current on-chain token balances, read live from the blockchain through Moralis. Unlike the tracker and leaderboard, which are built from the trades CabalSpy observes, this endpoint reflects what the wallet actually holds on chain right now, including the native coin. Because it reads raw balances from the chain, it has no cost basis and therefore no PnL. It answers one question only, what does this wallet hold at this moment.
This endpoint is period independent. It may return loading true for a brief moment while the balance cache warms up, in that case simply call it again. The wallet must be tracked by CabalSpy, otherwise you get a wallet not found error.

Query Parameters

string
required
Chain of the wallet. One of solana, bnb, base, eth, rh (Robinhood Chain).
string
required
The wallet address whose balances you want.
string
Your API key, required on https://api.cabalspy.xyz. Alternatively pass it as an Authorization Bearer header. Not needed on the demo server https://demo-api.cabalspy.xyz.
Try it without an API key: Try it runs on the demo server https://demo-api.cabalspy.xyz (20 requests per IP per day, data delayed 15 minutes, at most 5 rows), so you can send a request without a key. For live data, switch the server to https://api.cabalspy.xyz and enter your API key. Your own integration always calls api.cabalspy.xyz with your API key, as in the usage examples below. Get a free key · About the demo

Usage Example

Response

boolean
True on success.
object

Errors