# Crypto Tokenomics API
> Live crypto tokenomics — supply and dilution metrics for any cryptocurrency, powered by CoinGecko. For any coin it returns the circulating, total and maximum supply, the percentage of the maximum supply already issued, the market cap and the fully-diluted valuation (FDV), and the market-cap-to-FDV ratio — the share of supply already unlocked — together with the dilution overhang, the percentage of FDV still locked or yet to be minted. It can also rank the top coins by dilution overhang (which assets have the most future supply hanging over them) or by how much of their cap is issued. The supply-and-dilution layer that token research, due diligence and risk dashboards need. Live, no key, no cache. Distinct from price, market-cap and all-time-high APIs — this is the tokenomics analytic.

## 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/tokenomics-api/..."
```

## Pricing
- **Free** (Free) — 8,000 calls/Mo, 5 req/s
- **Starter** ($11/Mo) — 115,000 calls/Mo, 15 req/s
- **Pro** ($32/Mo) — 560,000 calls/Mo, 40 req/s
- **Desk** ($76/Mo) — 2,900,000 calls/Mo, 100 req/s

## Endpoints

### Supply

#### `GET /v1/supply` — A coin supply and dilution metrics

**Parameters:**
- `coin` (query, required, string) — Coin id or symbol Example: `bitcoin`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/tokenomics-api/v1/supply?coin=bitcoin"
```

**Response:**
```json
{
    "data": {
        "id": "bitcoin",
        "name": "Bitcoin",
        "rank": 1,
        "price": 62858,
        "symbol": "BTC",
        "market_cap": 1258711450887,
        "max_supply": 21000000,
        "mcap_to_fdv": 1,
        "total_supply": 20039087,
        "has_max_supply": true,
        "percent_issued": 95.42,
        "circulating_supply": 20039087,
        "dilution_overhang_pct": 0,
        "fully_diluted_valuation": 1258711450887
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:18.447Z",
        "request_id": "3f2cb53c-db23-4ec3-b4dc-5a0d435dacb2"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Leaders

#### `GET /v1/leaders` — Top-100 ranked by overhang or issuance

**Parameters:**
- `order` (query, optional, string) — overhang (most locked supply) | issued (least of cap issued) Example: `overhang`
- `limit` (query, optional, string) — Max coins (1-100) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/tokenomics-api/v1/leaders?order=overhang&limit=20"
```

### Search

#### `GET /v1/search` — Resolve a coin name/symbol to its id

**Parameters:**
- `q` (query, required, string) — Coin name or symbol Example: `arbitrum`
- `limit` (query, optional, string) — Max results (1-25) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/tokenomics-api/v1/search?q=arbitrum&limit=10"
```

**Response:**
```json
{
    "data": {
        "coins": [
            {
                "id": "arbitrum",
                "name": "Arbitrum",
                "rank": 103,
                "symbol": "ARB"
            },
            {
                "id": "makerdao-arbitrum-nova-dai-bridge-arbitrum-nova",
                "name": "MakerDAO Arbitrum Nova DAI Bridge (Arbitrum Nova)",
                "rank": 6670,
                "symbol": "DAI"
            },
            {
                "id": "aarna-atv111-arbitrum",
                "name": "aarna atv111 (Arbitrum)",
                "rank": 12451,
                "symbol": "ATV111"
            },
            {
                "id": "runblox-arbitrum",
                "name": "RunBlox (Arbitrum)",
                "rank": null,
                "symbol": "RUX"
            },
            {
                "id": "arbitrum-ecosystem-index",
                "name": "Arbitrum Ecosystem Index",
                "rank": null,
                "symbol": "ARBI"
            },
            {
                "id": "aarna-atv-usdc",
                "name": "aarna atv USDC (Arbitrum)",
                "rank": null,
                "symbol": "ATVUSDC"
            },
            {
                "id": "wrapped-aave-arbitrum-gho",
                "name": "Wrapped Aave Arbitrum GHO",
                "rank": null,
                "symbol": "WAARBGHO"
            },
            {
                "id": "wrapped-aave-arbitrum-usdt",
                "name": "Wrapped Aave Arbitr
…(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/tokenomics-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "CoinGecko public markets + search (live)",
        "service": "tokenomics-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/search": "Resolve a coin name/symbol to its id (q=arbitrum).",
            "GET /v1/supply": "A coin's supply + dilution metrics (coin=bitcoin or coin=BTC).",
            "GET /v1/leaders": "Top-100 ranked by dilution overhang or issuance (order=overhang|issued, limit)."
        },
        "description": "Live crypto tokenomics from CoinGecko: for any coin, the circulating/total/maximum supply, the percent of max supply issued, market cap and fully-diluted valuation (FDV), the market-cap-to-FDV ratio (share of supply unlocked) and the dilution overhang (percent of FDV still locked or unminted). Also ranks the top coins by dilution overhang or by how much of their cap is issued. Live, no key. Distinct from price, market-cap and all-time-high APIs — this is the supply-and-dilution analytic.",
        "upstream_status": null
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:21.938Z",
        "request_id": "bc72e2b1-0c83-4d57-ad26-e6e1644b7ae9"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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