Covalent Token Holders
covalent_token_holdersTop holders of token X on chain Y, the largest wallet holders of an ERC-20 token contract, with balances. Works across 100+ chains via Covalent/GoldRush. Example: covalent_token_holders({ token_address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", chain: "eth-mainnet", _apiKey: "your-key" })
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"chain": "eth-mainnet",
"_apiKey": "your-covalent-api-key",
"token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
},
"name": "covalent_token_holders"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain name (Covalent format), e.g. "eth-mainnet", "matic-mainnet", "base-mainnet", "bsc-mainnet", "arbitrum-mainnet". A numeric chain id also works. Default "eth-mainnet". | |
| _apiKey | Yes | Covalent / GoldRush API key (free tier at goldrush.dev) | |
| token_address | Yes | ERC-20 token contract address (0x...) |