On-chain (Ethereum & BSC)
Multi-chain on-chain data for Ethereum and BNB Smart Chain: top token holders per ERC20/BEP20 contract and wallet balances (native + tokens) with USD portfolio value. All amounts are exact raw integers plus decimal strings.
Token Holders (ETH/BSC)
Top holders of an ERC20 (Ethereum) or BEP20 (BNB Smart Chain) token contract: address, exact raw balance, decimal balance and % of total supply, with paging over the top 100 holders. Also returns token info (name, symbol, decimals, total supply, holder count, USD price). Non-token addresses return 400.
/v1/finance:onchain/token-holdersParameters
| Name | Type | In | Description |
|---|---|---|---|
| chain | enum | query | Chain: `eth` (Ethereum) or `bsc` (BNB Smart Chain). One of eth, bsc. Required. |
| contract | string | query | ERC20/BEP20 token contract address (0x + 40 hex). Required. |
| page | number | query | Page number. Default 1. |
| limit | number | query | Holders per page (1-100). Default 50. The top 100 holders are available. |
Example response
{"project":"finance:onchain","data":null,"timestamp":"2026-10-31T03:17:03Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Wallet Balances & Portfolio (ETH/BSC)
Wallet portfolio on Ethereum or BNB Smart Chain: exact native balance (ETH/BNB, wei precision, with block number), all ERC20/BEP20 token balances (raw + decimal), USD price and value per token, and total portfolio value in USD. Tokens sorted by USD value; onlyPriced=true hides unpriced/spam tokens. Empty wallets return 0.
/v1/finance:onchain/walletParameters
| Name | Type | In | Description |
|---|---|---|---|
| chain | enum | query | Chain: `eth` (Ethereum) or `bsc` (BNB Smart Chain). One of eth, bsc. Required. |
| address | string | query | Wallet address (0x + 40 hex). Required. |
| onlyPriced | boolean | query | true = only return tokens that have a USD price (hides most spam tokens). Default false. |
| limit | number | query | Max tokens returned, sorted by USD value (1-1000). Default 100. totalValueUsd always covers all tokens. |
Example response
{"project":"finance:onchain","data":null,"timestamp":"2026-10-31T03:17:03Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "finance:onchain", "token-holders", { chain: "eth", contract: "0xdAC17F958D2ee523a2206206994597C13D831ec7", page: 1, limit: 50 });
On-chain (Ethereum & BSC)
Multi-chain on-chain data for Ethereum and BNB Smart Chain: top token holders per ERC20/BEP20 contract and wallet balances (native + tokens) with USD portfolio value. All amounts are exact raw integers plus decimal strings.
Top holders of an ERC20 (Ethereum) or BEP20 (BNB Smart Chain) token contract: address, exact raw balance, decimal balance and % of total supply, with paging over the top 100 holders. Also returns token info (name, symbol, decimals, total supply, holder count, USD price). Non-token addresses return 400.
/v1/…onchain/token-holdersTry it
Parameters
chain
enum · query · required
Chain: `eth` (Ethereum) or `bsc` (BNB Smart Chain).
contract
string · query · required
ERC20/BEP20 token contract address (0x + 40 hex).
page
number · query · optional
Page number. Default 1.
limit
number · query · optional
Holders per page (1-100). Default 50. The top 100 holders are available.
Example response
{"project":"finance:onchain","data":null,"timestamp":"2026-10-31T03:17:03Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "finance:onchain", "token-holders", { chain: "eth", contract: "0xdAC17F958D2ee523a2206206994597C13D831ec7", page: 1, limit: 50 });