> ## Documentation Index
> Fetch the complete documentation index at: https://docs.etherscan.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Onchain Analytics and Research

> Build dashboards, research reports, and protocol monitors from entity labels, holder distributions, event logs, and network stats.

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](/make-your-first-call).

<Tip>
  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](/supported-chains) for the full list.
</Tip>

## Entity attribution

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

<Steps>
  <Step title="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.

    ```bash theme={null}
    curl --request GET \
      --url 'https://api.etherscan.io/v2/api?chainid=1&module=nametag&action=getlabelmasterlist&apikey=YourApiKey'
    ```
  </Step>

  <Step title="Resolve an address to its entity">
    Return the name tag, labels, and category for a specific address, part of [Etherscan Metadata](/metadata/introduction). 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.

    ```bash theme={null}
    curl --request GET \
      --url 'https://api.etherscan.io/v2/api?chainid=1&module=nametag&action=getaddresstag&address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&apikey=YourApiKey'
    ```
  </Step>
</Steps>

## Holder distribution

Measure how concentrated a token's ownership is.

<Steps>
  <Step title="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](/rate-limits) and above.

    ```bash theme={null}
    curl --request GET \
      --url 'https://api.etherscan.io/v2/api?chainid=1&module=token&action=tokenholderlist&contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&page=1&offset=100&apikey=YourApiKey'
    ```
  </Step>
</Steps>

## Event indexing

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

<Steps>
  <Step title="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.

    ```bash theme={null}
    curl --request GET \
      --url 'https://api.etherscan.io/v2/api?chainid=1&module=logs&action=getLogs&address=0xdAC17F958D2ee523a2206206994597C13D831ec7&fromBlock=0&toBlock=latest&page=1&offset=1000&apikey=YourApiKey'
    ```
  </Step>
</Steps>

## Network trends

Read chain-level metrics for research and reporting.

<Steps>
  <Step title="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](/rate-limits) and above.

    ```bash theme={null}
    curl --request GET \
      --url 'https://api.etherscan.io/v2/api?chainid=1&module=stats&action=dailytx&startdate=2026-01-01&enddate=2026-01-31&sort=asc&apikey=YourApiKey'
    ```
  </Step>

  <Step title="Get the native token supply">
    The current total supply of the chain's native coin, a common denominator for supply and market metrics.

    ```bash theme={null}
    curl --request GET \
      --url 'https://api.etherscan.io/v2/api?chainid=1&module=stats&action=ethsupply&apikey=YourApiKey'
    ```

    <Note>
      Some stats and holder endpoints require a paid plan. See [PRO endpoints](/endpoint-overview).
    </Note>
  </Step>
</Steps>

## 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.