# Protocol Fees & Revenue Rankings by Chain

> Protocol Fees & Revenue Rankings by Chain is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-01).

Returns ranked protocols by fees earned or revenue generated over the past 24h or 7d, optionally filtered to a single chain.

## Facts

- Endpoint: POST https://twin.unykorn.org/defi/fees?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/protocol-fees-revenue-rankings-by-chain-8fd1e595
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8SBzJjdmZnaMoIsb4OzP2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability protocol-fees-revenue-rankings-by-chain-8fd1e595 -d '<json body>'
```

Example prompt: Show me the top 20 DeFi protocols ranked by fees earned in the last 24 hours across all chains.

## When to prefer this

Use this endpoint when you need to rank or compare DeFi protocols by economic output (fees or revenue) across one or all chains, especially for daily or weekly summaries. Prefer this over general DeFi TVL endpoints when the user's goal is fee or revenue ranking rather than liquidity size.

## Known failure modes

- Invalid chain name returns no results or an error
- Limit exceeding 100 is rejected or clamped
- Invalid metric enum value returns an error
- Missing or stale data for a specific chain may return partial results
- Service unavailable may return a 402 or 5xx error

## How this service works

Protocol fees and revenue: who earns the most (24h/7d), all chains or one chain — Genesis402 / UnyKorn Operator Network

## Output

An ordered list of protocols ranked by the selected metric (fees or revenue), each entry including protocol name, earned amount, and relevant chain, covering the specified time window (24h or 7d), up to the requested row limit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "chain": {
     "type": "string",
     "description": "optional"
    },
    "limit": {
     "type": "integer",
     "maximum": 100,
     "minimum": 1,
     "description": "optional: max rows (default 20, max 100)"
    },
    "metric": {
     "enum": [
      "fees",
      "revenue"
     ],
     "type": "string",
     "description": "optional: fees (default) | revenue"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "defi-fees",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.005,
   "receipt_id": "g402-<16hex>"
  },
  "sources": [
   {
    "ok": true,
    "name": "<source>"
   }
  ],
  "limitations": "<text>",
  "generated_at": "<iso time>",
  "evidence_hash": "sha256:<64hex>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/protocol-fees-revenue-rankings-by-chain-8fd1e595/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)