# 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"
```

### 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"
```

### 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"
```

### Meta

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

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


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