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

# Chains

> Daily users, transactions, fees and revenue for blockchains, plus a chain-level CHAIN_* family for TVL, users and transaction costs on the base layer itself

Chains carry two overlapping metric families. `DAU`, `TXNS`, `FEES`, `REVENUE` and `NEW_USERS` are the same on-chain activity metrics Artemis uses for protocols and apps. `CHAIN_DAU`, `CHAIN_TXNS`, `CHAIN_FEES`, `CHAIN_TVL` and the rest of the `CHAIN_*` family measure the base layer specifically. Activity counts (`TXNS`, `CHAIN_TXNS`, `FEES`, `CHAIN_FEES`) are daily sums; user counts (`DAU`, `NEW_USERS`, `CHAIN_DAU`, `CHAIN_MAU`) are daily averages; `CHAIN_TVL` is an end-of-day snapshot.

Chains are the largest metric surface in the API. `eth` alone supports 104 metrics. The table below is a core set for cross-chain comparison; call [`GET /supported-metrics/`](/docs/artemis-api/discovery) on any chain symbol for the rest.

## Metrics

| Metric              | Label                         | Unit     | Aggregation |
| ------------------- | ----------------------------- | -------- | ----------- |
| `DAU`               | Daily Active Users            | Nominal  | `AVERAGE`   |
| `TXNS`              | Transactions                  | Nominal  | `SUM`       |
| `FEES`              | Fees                          | Currency | `SUM`       |
| `REVENUE`           | Revenue                       | Currency | `SUM`       |
| `NEW_USERS`         | New Users                     | Nominal  | `AVERAGE`   |
| `CHAIN_DAU`         | Daily Active Users (Chain)    | Nominal  | `AVERAGE`   |
| `CHAIN_TXNS`        | Chain Transactions            | Nominal  | `SUM`       |
| `CHAIN_FEES`        | Chain Fees                    | Currency | `SUM`       |
| `CHAIN_TVL`         | Chain TVL                     | Currency | `LAST`      |
| `CHAIN_MAU`         | Chain MAU                     | Nominal  | `AVERAGE`   |
| `CHAIN_AVG_TXN_FEE` | Chain Average Transaction Fee | Currency | `AVERAGE`   |
| `CHAIN_SPOT_VOLUME` | Spot Volume (Chain)           | Currency | `SUM`       |

`DAU` is defined as addresses using a protocol's products; `CHAIN_DAU` is specifically addresses that send a transaction on the chain. For `eth`, `trx` and `sol` on 2026-08-01 the two returned identical values. `FEES` and `CHAIN_FEES` do diverge on `eth`: `FEES` also folds in application-level fees from DeFi protocols built on top of the chain, on top of raw gas: \$193,124.92 versus `CHAIN_FEES`'s \$193,103.06 on the same day.

<Warning>
  Chain-level figures live in the `CHAIN_*` family: use `CHAIN_MAU`, `CHAIN_AVG_TXN_FEE` and `CHAIN_TVL`. For burn value, `eth`'s `REVENUE` is the USD value of ETH burned via EIP-1559.
</Warning>

## Covered chains

Artemis covers 112 chains, including:

`eth` · `sol` · `btc` · `base` · `arb` · `bnb` · `trx` · `op` · `pol` · `avax` · `sui` · `apt` · `near` · `ton` · `hype` · `linea` · `xrp` · `ada` · `unichain` · `mnt`

For the full list, filter [`GET /asset/`](/docs/artemis-api/discovery) by sector.

## Example: Daily users, transactions, fees and revenue

```bash theme={null}
curl -s "https://data-svc.artemisxyz.com/v2/data/DAU,TXNS,FEES,REVENUE?symbols=trx,sol,bnb,eth,base,arb&startDate=2026-07-25&endDate=2026-08-01&summarize=true&APIKey=$ARTEMIS_API_KEY"
```

| Chain     | DAU       | Transactions | Fees      | Revenue   |
| --------- | --------- | ------------ | --------- | --------- |
| Tron      | 3,924,456 | 13,371,775   | \$899,742 | \$899,742 |
| Solana    | 3,187,274 | 119,721,261  | \$423,018 | \$522,786 |
| BNB Chain | 2,083,290 | 18,403,928   | \$807,056 | \$807,056 |
| Ethereum  | 439,738   | 1,827,075    | \$193,125 | \$193,125 |
| Base      | 239,854   | 7,636,012    | \$35,830  | \$35,706  |
| Arbitrum  | 133,039   | 1,743,925    | \$13,180  | \$3,494   |

Because this request uses `summarize=true`, every figure above is the **2026-08-01 value**, not an eight-day total. `summarize` returns the `endDate` day regardless of whether a metric is `SUM`, `LAST` or `AVERAGE`. See [Core concepts](/docs/artemis-api/core-concepts).

Fees and revenue aren't the same quantity, and `/supported-metrics/` explains why they diverge here. Solana's `REVENUE` description specifically includes "Jito tips accruing to SOL stakers" on top of base, priority and vote fees (value `FEES` doesn't count), which is why revenue (\$522,786) comes in above fees (\$423,018). Arbitrum's `REVENUE` is defined as fees paid to the sequencer **minus** the cost of posting that transaction data back to Ethereum mainnet, which is why its revenue (\$3,494) sits far below its fees (\$13,180).

## Chain TVL

```bash theme={null}
curl -s "https://data-svc.artemisxyz.com/v2/data/CHAIN_TVL?symbols=eth,sol,base,trx,bnb,arb&startDate=2026-08-01&endDate=2026-08-01&APIKey=$ARTEMIS_API_KEY"
```

| Chain     | Chain TVL |
| --------- | --------- |
| Ethereum  | \$37.99B  |
| Solana    | \$4.45B   |
| Base      | \$3.99B   |
| Tron      | \$3.31B   |
| BNB Chain | \$2.60B   |
| Arbitrum  | \$1.35B   |

## Split by category

Chain-level metrics are reported as a single total per chain, so the `CHAIN_*` family carries `dimension_type: TOTAL` and isn't split further. Each metric's `cuts` array in [`GET /supported-metrics/`](/docs/artemis-api/discovery) lists the dimensions it supports.

The plain `DAU`, `TXNS` and `NEW_USERS` metrics list both `TOTAL` and `CATEGORY` cuts, and `CATEGORY` does resolve for `DAU` and `TXNS`:

```bash theme={null}
curl -s "https://data-svc.artemisxyz.com/v2/data/DAU?symbols=eth&startDate=2026-08-01&endDate=2026-08-01&dimensionType=CATEGORY&APIKey=$ARTEMIS_API_KEY"
```

Ethereum's `DAU` by category on 2026-08-01, top ten of twenty:

| Category            | DAU     |
| ------------------- | ------- |
| EOA                 | 184,521 |
| Stablecoin          | 156,201 |
| Bridge              | 93,747  |
| Untagged Real Users | 82,621  |
| Cefi                | 34,022  |
| Defi                | 14,170  |
| NFT App             | 12,744  |
| Infrastructure      | 7,403   |
| Unlabeled           | 6,145   |
| Token               | 2,911   |

Unlike the chain splits on [Lending](/docs/artemis-api/metrics/lending) and [Stablecoins](/docs/artemis-api/metrics/stablecoins), this one isn't a clean partition. All twenty categories sum to 605,380, well above the undifferentiated `DAU` total of 439,738 for the same day, because an address active in more than one category (for example a stablecoin transfer routed through a bridge) is counted in each. Treat the category split as directional, not additive.

Each metric's `cuts` array lists the dimensions it supports, and a live call confirms a breakdown's shape before you build on it.