# Crypto Fees API
> Live crypto protocol fee and revenue data across the whole ecosystem as an API, streamed from the DefiLlama fees feed. For thousands of protocols and chains: the fees paid by users over the last 24 hours, 7 days and 30 days, the all-time total, and the day/week/month change. Rank the protocols actually earning the most — a fundamental "who makes money" view of crypto — drill into any single protocol, read the market-wide fee total, or search. Built for crypto, fundamental-analysis and dashboard apps. Live, no key. Distinct from TVL, yield, stablecoin-supply and price APIs — this is the fee and revenue surface.

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

## Pricing
- **Free** (Free) — 200 calls/Mo, 3 req/s
- **Analyst** ($14/Mo) — 8,500 calls/Mo, 8 req/s
- **Pro** ($36/Mo) — 42,000 calls/Mo, 20 req/s
- **Fund** ($86/Mo) — 210,000 calls/Mo, 40 req/s

## Endpoints

### Fees

#### `GET /v1/protocol` — One protocol's fees

**Parameters:**
- `name` (query, required, string) — Protocol name Example: `Tether`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptofees-api/v1/protocol?name=Tether"
```

**Response:**
```json
{
    "data": {
        "protocol": {
            "name": "Tether",
            "chains": [
                "Off Chain"
            ],
            "fees_7d": 114742772,
            "category": "Stablecoin Issuer",
            "fees_24h": 16346503,
            "fees_30d": 492390879,
            "change_1d_pct": 0,
            "change_7d_pct": 0.15,
            "fees_all_time": 17958289532,
            "change_30d_pct": -0.62
        }
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:21.091Z",
        "request_id": "c272ffd0-995a-49f9-b6cc-b7e5d8268443"
    },
    "status": "ok",
    "message": "Protocol retrieved successfully",
    "success": true
}
```

#### `GET /v1/search` — Search protocols

**Parameters:**
- `q` (query, required, string) — Search term Example: `uniswap`
- `limit` (query, optional, string) — Max 1-200 Example: `25`

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

**Response:**
```json
{
    "data": {
        "count": 5,
        "query": "uniswap",
        "total": 5,
        "protocols": [
            {
                "name": "Uniswap V4",
                "chains": [
                    "Ethereum",
                    "Unichain",
                    "OP Mainnet",
                    "Base",
                    "Arbitrum",
                    "Polygon",
                    "Blast",
                    "Zora",
                    "World Chain",
                    "Ink",
                    "Soneium",
                    "Avalanche",
                    "BSC",
                    "Monad",
                    "X Layer"
                ],
                "fees_7d": 6772589,
                "category": "Dexs",
                "fees_24h": 2286548,
                "fees_30d": 30638180,
                "change_1d_pct": 271.68,
                "change_7d_pct": 120.94,
                "fees_all_time": 264006168,
                "change_30d_pct": 274.76
            },
            {
                "name": "Uniswap V3",
                "chains": [
                    "Ethereum",
                    "Arbitrum",
                    "OP Mainnet",
                    "Polygon",
                    "Celo",
                    "BSC",
                    "ZKsync Era",
                    "Sei",
                    "Taiko",
                    "Scroll",
                    "Rootstock",
                    "Filecoin",
                    "Boba",
                    "Moonbeam"
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/top` — Top protocols by fees

**Parameters:**
- `sort` (query, optional, string) — 24h | 7d | 30d | all Example: `24h`
- `chain` (query, optional, string) — Chain filter, e.g. Ethereum
- `category` (query, optional, string) — Category filter
- `limit` (query, optional, string) — Max 1-200 Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptofees-api/v1/top?sort=24h&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "24h",
        "chain": "all",
        "count": 25,
        "total": 1994,
        "category": "all",
        "protocols": [
            {
                "name": "Tether",
                "chains": [
                    "Off Chain"
                ],
                "fees_7d": 114742772,
                "category": "Stablecoin Issuer",
                "fees_24h": 16346503,
                "fees_30d": 492390879,
                "change_1d_pct": 0,
                "change_7d_pct": 0.15,
                "fees_all_time": 17958289532,
                "change_30d_pct": -0.62
            },
            {
                "name": "Circle USDC",
                "chains": [
                    "Ethereum",
                    "Off Chain"
                ],
                "fees_7d": 45125243,
                "category": "Stablecoin Issuer",
                "fees_24h": 6437723,
                "fees_30d": 194072272,
                "change_1d_pct": 0.26,
                "change_7d_pct": 0.57,
                "fees_all_time": 6758873014,
                "change_30d_pct": -3.61
            },
            {
                "name": "Saturn",
                "chains": [
                    "Ethereum"
                ],
                "fees_7d": -1067311,
                "category": "Stablecoin Wrapper",
                "fees_24h": 3192034,
                "fees_30d": -1850108,
                "change_1d_pct": null,
                "change_7d_pct": -490.15,
   
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/total` — Market-wide fee totals

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

**Response:**
```json
{
    "data": {
        "change_1d_pct": 12.18,
        "change_7d_pct": -2.96,
        "total_fees_7d": 433240001,
        "change_30d_pct": 9.44,
        "total_fees_24h": 55779813,
        "total_fees_30d": 1683161283,
        "protocols_tracked": 2263
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:21.711Z",
        "request_id": "44e8a5f1-170e-4b03-af68-170b888bfbb0"
    },
    "status": "ok",
    "message": "Total fees retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "sorts": [
            "24h",
            "7d",
            "30d",
            "all"
        ],
        "source": "DefiLlama fees overview (live)",
        "service": "cryptofees-api",
        "endpoints": {
            "GET /v1/top": "Top protocols by fees (sort=24h|7d|30d|all, chain=, category=, limit).",
            "GET /v1/meta": "This document.",
            "GET /v1/total": "Market-wide fee totals and change.",
            "GET /v1/search": "Search protocols by name or category (q=).",
            "GET /v1/protocol": "One protocol's fees (name=, e.g. Tether)."
        },
        "description": "Live crypto protocol fee & revenue data from DefiLlama (overview/fees): fees paid over 24h/7d/30d, all-time total and period change, for thousands of protocols and chains. Rank top fee-earning protocols, drill into one, read the market-wide total, or search. Live, no key. Distinct from TVL, yield, stablecoin and price APIs — this is the fee/revenue surface.",
        "total_fees_24h": 55779813,
        "protocols_tracked": 2263
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:21.928Z",
        "request_id": "ca699076-9a7d-4729-8553-1311668b3e01"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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