Loading capabilities…
Loading capability…
Return top holders for a token with provider-native balances and metadata.
Both commands call the selected provider directly.
curl -X POST '/routes/nansen/crypto/token-holders' \
-H 'content-type: application/json' \
-d '{"chain":"base","token_address":"0x833589fCD6eDb6E08f4C7C32D4f71b54bdA02913","pagination":{"per_page":25}}'h402 call 'crypto/token-holders' --provider 'nansen' --method POST --json '{"chain":"base","token_address":"0x833589fCD6eDb6E08f4C7C32D4f71b54bdA02913","pagination":{"per_page":25}}'Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.
chainstringrequiredChain slug from Nansen's TGMHoldersChain enum (docs.nansen.ai, verified 2026-07-07).
token_addressstringrequiredToken contract address or chain-native token address.
label_typestringoptionalHolder segment such as all_holders, smart_money, whale, exchange, or public_figure.
paginationobjectoptionalpagination.pageintegeroptional≥ 1pagination.per_pageintegeroptional1–1000default 25filtersobjectoptionalOptional Nansen filter object, passed through as-is.
order_byarrayoptionalOptional Nansen sort order array, passed through as-is.
{
"chain": "base",
"token_address": "0x833589fCD6eDb6E08f4C7C32D4f71b54bdA02913",
"pagination": {
"per_page": 25
}
}{ "data": { "data": [ { "address": "0xbbbbbbbbbb9cc5e90e3b3af64bdaf62c37eeffcb", "address_label": "Token Billionaire", "token_amount": 176113947.542601, "total_outflow": 3726876822642.2456, "total_inflow": 3727052936589.788, "balance_change_24h": 13049164.225366, "balance_change_7d": 1363112.942509, "balance_change_30d": 16180256.662628, "ownership_percentage": 0, "value_usd": 176089578.16026178 }, { "address": "0x8da91a6298ea5d1a8bc985e99798fd0a0f05701a", "address_label": "Token Millionaire", "token_amount": 160000000.210698, "total_outflow": 0, "total_inflow": 160000000.210698, "balance_change_24h": 0, "balance_change_7d": 0, "balance_change_30d": 0, "ownership_percentage": 0, "value_usd": 159977860.5605805 }, { "address": "0xb026ba5501c9fcdb5b4b746c37e349cd61b81b22", "address_label": "Token Millionaire", "token_amount": 158707811.660177, "total_outflow": 0, "total_inflow": 158707811.660177, "balance_change_24h": 0, "balance_change_7d": 0, "balance_change_30d": 0, "ownership_percentage": 0, "value_usd": 158685850.8138242 } ], "pagination": { "page": 1, "per_page": 10, "is_last_page": false }, "warnings": null }, "h402": { "routeId": "crypto/token-holders", "provider": "nansen", "selectedCandidateId": "crypto/token-holders/nansen", "routing": "manual", "paidBy": "x402-exact" } }
Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.