Skip to main content
POST /v1/data/crypto/token-holders/run Pricing: $0.0025 per token holder ($2.50 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
required
The contract address of the token to look up holders for.
string
required
The blockchain network the token contract is deployed on.Allowed values: ethereum (Ethereum), polygon (Polygon), bsc (BSC), solana (Solana), avalanche (Avalanche), arbitrum (Arbitrum), optimism (Optimism), base (Base).
integer
default:"20"
How many token holders to return in total. Defaults to 20; use 0 for all.Max 100.

Example

Response fields

Each row in data is one token holder, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
To label the holder addresses use crypto/wallets; for a wallet’s transfers use crypto/wallet-transfers.