# growthepie L2 Economics API
> Live economic-activity metrics for Ethereum Layer-2 rollups — Arbitrum, Base, Optimism, zkSync, Linea, Scroll, Polygon and more — powered by the public growthepie.xyz feed, no key, nothing stored. This is the L2 fundamentals cut: not a single chain's block or gas data, but how much each rollup is actually used and what it earns. The chains endpoint lists the tracked rollups. The chain endpoint returns one rollup's latest metrics: daily active addresses, transaction count, fees paid, on-chain profit (the fees it keeps after paying Ethereum to post its data), median transaction cost, stablecoin supply, total value locked, market cap and fully-diluted valuation. The metric endpoint ranks every rollup by a single metric, so you can see at a glance which L2 leads on users, fees or profit and how the scaling race is shifting. Track the real adoption and economics of the rollup ecosystem as live JSON. This is the L2 activity / economics cut — distinct from the per-chain on-chain (block and gas) APIs and the TVL-only APIs in the catalogue.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/growthepie-api/..."
```

## Pricing
- **Free** (Free) — 18,000 calls/Mo, 3 req/s
- **Analyst** ($8/Mo) — 210,000 calls/Mo, 10 req/s
- **Pro** ($24/Mo) — 870,000 calls/Mo, 28 req/s
- **Scale** ($55/Mo) — 3,050,000 calls/Mo, 60 req/s

## Endpoints

### Chains

#### `GET /v1/chains` — List tracked L2 rollups

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/growthepie-api/v1/chains"
```

**Response:**
```json
{
    "data": {
        "count": 29,
        "chains": [
            {
                "key": "arbitrum",
                "name": "Arbitrum One",
                "layer": null
            },
            {
                "key": "arbitrum_nova",
                "name": "Arbitrum Nova",
                "layer": null
            },
            {
                "key": "base",
                "name": "Base Chain",
                "layer": null
            },
            {
                "key": "celo",
                "name": "Celo",
                "layer": null
            },
            {
                "key": "fraxtal",
                "name": "Fraxtal",
                "layer": null
            },
            {
                "key": "gravity",
                "name": "Gravity",
                "layer": null
            },
            {
                "key": "ink",
                "name": "Ink",
                "layer": null
            },
            {
                "key": "linea",
                "name": "Linea",
                "layer": null
            },
            {
                "key": "lisk",
                "name": "Lisk",
                "layer": null
            },
            {
                "key": "loopring",
                "name": "Loopring",
                "layer": null
            },
            {
                "key": "manta",
                "name": "Manta Pacific",
                "layer": null
            },
            {
                "key"
…(truncated, see openapi.json for full schema)
```

### Chain

#### `GET /v1/chain` — One rollup latest activity metrics

**Parameters:**
- `chain` (query, required, string) — Rollup key Example: `arbitrum`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/growthepie-api/v1/chain?chain=arbitrum"
```

**Response:**
```json
{
    "data": {
        "chain": "arbitrum",
        "source": "growthepie",
        "metrics": {
            "daa": {
                "date": "2026-06-10",
                "value": 117694
            },
            "tvl": {
                "date": "2026-06-10",
                "value": 16028548871.18
            },
            "fdv_usd": {
                "date": "2026-06-11",
                "value": 774257058.06
            },
            "txcount": {
                "date": "2026-06-10",
                "value": 1525635
            },
            "profit_usd": {
                "date": "2026-06-10",
                "value": 14989.3
            },
            "stables_mcap": {
                "date": "2026-06-10",
                "value": 4874311406.11
            },
            "fees_paid_usd": {
                "date": "2026-06-10",
                "value": 15050.28
            },
            "rent_paid_usd": {
                "date": "2026-06-10",
                "value": 60.98
            },
            "gas_per_second": {
                "date": "2026-06-10",
                "value": 3.41
            },
            "market_cap_usd": {
                "date": "2026-06-11",
                "value": 484258664.89
            },
            "txcosts_median_usd": {
                "date": "2026-06-10",
                "value": 0
            }
        }
    },
    "meta": {
        "timestamp": "2026-06-12T01:43:06.256Z",
        "request_id": "cd01199d-528b-4340-892d-771560
…(truncated, see openapi.json for full schema)
```

### Metric

#### `GET /v1/metric` — Every rollup ranked by one metric

**Parameters:**
- `metric` (query, optional, string) — active_addresses, txcount, fees, profit, txcosts, tvl, stablecoins, market_cap, fdv Example: `active_addresses`
- `limit` (query, optional, string) — Max rows (1-50) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/growthepie-api/v1/metric?metric=active_addresses&limit=50"
```

**Response:**
```json
{
    "data": {
        "count": 28,
        "metric": "daa",
        "source": "growthepie",
        "ranking": [
            {
                "date": "2026-06-10",
                "name": "Polygon PoS",
                "chain": "polygon_pos",
                "value": 937111
            },
            {
                "date": "2026-06-10",
                "name": "Base Chain",
                "chain": "base",
                "value": 494752
            },
            {
                "date": "2026-06-10",
                "name": "Celo",
                "chain": "celo",
                "value": 384841
            },
            {
                "date": "2026-06-10",
                "name": "Arbitrum One",
                "chain": "arbitrum",
                "value": 117694
            },
            {
                "date": "2026-06-10",
                "name": "ZKsync Era",
                "chain": "zksync_era",
                "value": 98917
            },
            {
                "date": "2026-06-10",
                "name": "Starknet",
                "chain": "starknet",
                "value": 64430
            },
            {
                "date": "2026-06-10",
                "name": "World Chain",
                "chain": "worldchain",
                "value": 42615
            },
            {
                "date": "2026-06-10",
                "name": "Ink",
                "chain": "ink",
                "value": 39892
            },
            {

…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/growthepie-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "USD metrics are dollars; daa = daily active addresses; profit = fees minus L1 data costs; txcosts = median tx cost (USD). metric accepts: active_addresses, txcount, fees, profit, txcosts, tvl, stablecoins, market_cap, fdv, rent_paid, throughput.",
        "source": "growthepie.xyz (api.growthepie.xyz/v1, live daily)",
        "service": "growthepie-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/chain": "One rollup's latest metrics — active addresses, txcount, fees, profit, costs, TVL (chain=arbitrum).",
            "GET /v1/chains": "List the tracked L2 rollups.",
            "GET /v1/metric": "Every rollup ranked by one metric (metric=active_addresses|fees|profit|tvl…, limit=50)."
        },
        "description": "Live economic-activity metrics for Ethereum Layer-2 rollups (Arbitrum, Base, Optimism, zkSync, Linea, Scroll and more), from growthepie.xyz. The L2 fundamentals cut: how much each rollup is used and what it earns. The chains endpoint lists tracked rollups; the chain endpoint returns one rollup's latest metrics (daily active addresses, transaction count, fees, on-chain profit, median transaction cost, stablecoin supply, TVL, market cap); the metric endpoint ranks every rollup by one metric. Live, no key, nothing stored. The L2 activity / economics cut — distinct from the per-chain on-chain (block/gas) and TVL-only APIs.",
        "tracked_rollups": 29,
        "upstream_status":
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/growthepie-api
OpenAPI spec: https://www.oanor.com/api/growthepie-api/openapi.json
