Skip to main content
Analytics turns raw onchain movement into a readable picture. This guide covers the pieces behind that: attributing activity to real entities, measuring holder distribution, indexing protocol events, and tracking network trends. New to the API? Start with Make your first call.
Every endpoint in this guide works on all 60+ supported chains, just switch the chainid. For example, set chainid=42161 to run the same analysis on Arbitrum. See Supported chains for the full list.

​
Entity attribution

Map anonymous addresses to named entities and categories, so a flow reads as “into an exchange” rather than “to an address”.
1

Get the full label list

Pull the master list of label categories once, then use it to classify the addresses in your dataset. The list changes slowly, so cache it and refresh periodically.
2

Resolve an address to its entity

Return the name tag, labels, and category for a specific address, part of Etherscan Metadata. Group transfers by labels to report flows by category, such as volume into exchanges or bridges. This is a PRO endpoint, available on the Pro Plus plan.

​
Holder distribution

Measure how concentrated a token’s ownership is.
1

Get the token holder list

The addresses holding a token and their balances. Divide each balance by total supply to compute its share, then rank to see concentration. This is a PRO endpoint, available to the Standard plan and above.

​
Event indexing

Pull a contract’s event logs to power dashboards and monitors.
1

Get contract event logs

Filter logs by address, topic, and block range. Decode the topics and data fields against the contract ABI to turn raw logs into structured events. Narrow fromBlock and toBlock to a window and page through results rather than requesting an unbounded range.
Read chain-level metrics for research and reporting.
1

Get the daily transaction count

Daily transaction counts over a date range, for activity trends and network comparisons. This is a PRO endpoint, available to the Standard plan and above.
2

Get the native token supply

The current total supply of the chain’s native coin, a common denominator for supply and market metrics.
Some stats and holder endpoints require a paid plan. See PRO endpoints.

​
Putting it together

Combine these endpoints to build common analytics and research workflows:
  • Flow-by-category reports: getlabelmasterlist + getaddresstag
  • Concentration analysis: tokenholderlist against total supply
  • Event dashboards and monitors: getLogs decoded against the contract ABI
  • Network trend tracking: dailytx + ethsupply
Run the same metrics on each chainid to compare networks side by side, or to aggregate a protocol deployed across several chains.