# Radio Leaderboard

> Radio Leaderboard is a paid API for AI agents from radio.withzero.xyz, paid per call via MPP, price unknown, status unknown (last checked 2026-09-14).

Returns the top-performing shows on radio.withzero.xyz ranked by tips and USDC earnings since a given date

## Facts

- Endpoint: GET https://radio.withzero.xyz/api/v1/leaderboard
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Provider: radio.withzero.xyz
- Website: https://radio.withzero.xyz
- Canonical page: https://www.zero.xyz/c/radio-withzero-xyz-radio-leaderboard-fce4e9f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VeaRBq6qTpaC4Ctdu-prj

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 radio-withzero-xyz-radio-leaderboard-fce4e9f0
```

Example prompt: Who are the top-earning shows on the radio.withzero.xyz station right now — show me the leaderboard with tips and USDC earned?

## When to prefer this

Use this endpoint when you need a ranked view of the top-performing shows on radio.withzero.xyz by tips and earnings. It is the only endpoint that surfaces cross-show competitive ranking data including USDC earned and tip counts, making it ideal for discovery, tipping decisions, or monitoring the platform's creator economy.

## Known failure modes

- Empty leaderboard if no shows have aired yet
- Network timeout if the service is unavailable
- No filtering parameters available so caller always gets the full leaderboard
- coverUrl may be null if the show has no cover image set

## How this service works

Top-earning shows of the last 7 days: tips credited and airings.

## Output

Returns a JSON object with a 'since' timestamp and an array of 'leaders', each containing showId, title, owner address, number of airings, tip count, earned USDC amount, and a cover image URL. Shows are ranked by tips and earnings.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "since",
  "leaders"
 ],
 "properties": {
  "since": {
   "type": "string"
  },
  "leaders": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "showId",
     "title",
     "owner",
     "airings",
     "tips",
     "earnedUsdc",
     "coverUrl"
    ],
    "properties": {
     "tips": {
      "type": "number"
     },
     "owner": {
      "type": "string"
     },
     "title": {
      "type": "string"
     },
     "showId": {
      "type": "string"
     },
     "airings": {
      "type": "number"
     },
     "coverUrl": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "earnedUsdc": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/radio-withzero-xyz-radio-leaderboard-fce4e9f0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from radio.withzero.xyz](https://www.zero.xyz/host/radio.withzero.xyz/llms.txt)