Token Holders
Get top token holders and their holdings for a token contract.
| Property | Value |
|---|---|
| Endpoint | /api/token/holders |
| Method | POST |
| Credits | 1 |
Request Body
chainstring, requiredChain name or ID (EVM chains only)
tokenAddressstring, requiredToken contract address
Supported Chains
This endpoint only supports EVM chains: Ethereum, BSC, Base, Arbitrum, Optimism, Polygon, Avalanche, zkSync, Scroll, Linea, Mantle, Merlin.
Example
curl -X POST https://kittyhome.pages.dev/api/token/holders \
-H "Authorization: Bearer kk_your_key" \
-H "Content-Type: application/json" \
-d '{"chain": "ethereum", "tokenAddress": "0x69825081..."}'
Response Data
{
"holders": [
{
"walletAddress": "0x...",
"amount": 1000000.5,
"usdValue": 2500000.75
}
]
}