Skip to main content
GET
Holders
List the tracked wallets holding a token, ranked by how much they hold. Each holder carries its profile and a live position with bag percentage, unrealized PnL, remaining value and the market cap at which it first entered. The token block carries the current market cap. This is the data behind a holder table, the classic view that shows which KOLs and smart money are sitting in a token and whether they are up or down on the position.
The live position fields (unrealized PnL, remaining value, entry market cap) are Solana only and null on other chains. entry_market_cap is null for positions that were opened before entry tracking started. Holders are sorted by amount held, highest first, and the list is paginated with limit and cursor.

Query Parameters

string
required
Chain of the token. One of solana, bnb, base, eth, rh (Robinhood Chain).
string
required
The token mint or contract address.
string
Optional wallet category kol, smart or whale. Omit to include all categories.
integer
Maximum number of holders to return.
string
Opaque cursor for the next page. Pass the next_cursor value from the previous response, together with the same limit. A null next_cursor means there are no more pages.
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