Tokens API
Who holds a Solana token in ZK-compressed form
The wallets holding one Solana mint as ZK-compressed tokens, with each raw compressed balance, a page at a time. Ordinary token accounts of the mint are not included.
/api/external/token-analysis/compressed-token-holders/{chain}/{mint}What it returns
Lists the wallets holding one mint as ZK-compressed tokens on Solana, each with its compressed balance in raw base units, a page at a time: keep passing cursor back until it is null. ONLY compressed balances are counted — the same mint's ordinary token accounts are not included here (the regular holders resources cover those), so this is not the token's full holder list. The order is the index's own and is NOT a ranking by balance. An empty holders is a real answer: nobody holds the mint in compressed form.
Chains
- Solana SOL
Request
Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.
curl -H "x-dex-data-key: $DEXDATA_API_KEY" \ "https://api.dexdata.io/api/external/token-analysis/compressed-token-holders/SOL/<mint>"
| Parameter | Description |
|---|---|
limitquery · integer · optional | How many holders per page: 1 to 1000. Defaults to 100. limit ≤ 350 keeps the answer under 32 KB. |
cursorquery · string · optional | The cursor of a previous response, for the next page of the same mint. An empty one, or one over 256 characters, is a 400. |
chainpath · string · required | SOL. Every other chain returns 400: compressed tokens are a Solana construct. |
mintpath · string · required | The token mint address, base58. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
mint | string | The mint asked about. |
slot | integer | The slot the compressed-state index answered at. |
holders | object[] | This page's holders, in the index's order — not ranked by balance. |
holders[].owner | string | The holding wallet. |
holders[].amountRaw | string | null | The wallet's compressed balance of the mint in RAW base units, as a decimal string (divide by the mint's decimals yourself). null only when the true figure is above 2^53: the balance reaches this service as a JSON number, which cannot carry it exactly, so no rounded figure is published. |
cursor | string | null | Pass back as cursor for the next page. null on the last page. |
Start building with DexData today
Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.
Get a free API key