Skip to content
Alchemy Logo

getTokenHoldersAtSlot

POST
/{apiKey}

Returns the token accounts holding a single SPL Token or Token-2022 mint as of a specific slot, ranked by balance.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

stringrequired

The base-58 encoded pubkey of the token mint. SPL Token and Token-2022 mints are both supported.

integerrequired

The slot to reconstruct the holder list at. There is no "latest slot" default; omitting slot is an error.

integeroptionaldefaults to 1000

How many holders to return. Defaults to 1000; the server ceiling is 10000.

enumoptionaldefaults to balance_desc

The ordering of the returned holders. Case-sensitive. sort_by is accepted as an alias.

The ordering of the returned holders. balance_desc (default) returns the largest balance first; balance_asc returns the smallest non-zero balance first. Case-sensitive. sort_by is accepted as an alias for sortBy.

Defaults to "balance_desc".

Allowed values:

Responses

200

The token accounts that held the mint at the requested slot, ranked by balance, along with the slot the result was computed at and the sort order applied.

Errors

-32602Invalid params. Common causes include a missing or malformed `mint` (must be a 32-byte base-58 pubkey), a missing or non-integer `slot`, a non-integer `limit`, an unknown `sortBy` value (only `balance_desc` and `balance_asc` are accepted, case-sensitive), a `params` value that is neither an array nor an object, or a mint that is not present in the index.
-32601Method not found.
-32603Internal error. Retry the request; if it persists, contact support.
Was this page helpful?