# Radio.WithZero Earnings Balance and Ledger

> Radio.WithZero Earnings Balance and Ledger is a paid API for AI agents from radio.withzero.xyz, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-09-15).

Returns the authenticated broadcaster's USDC earnings balance and a full ledger of tips received and airtime purchases on radio.withzero.xyz.

## Facts

- Endpoint: GET https://radio.withzero.xyz/api/v1/earnings
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Provider: radio.withzero.xyz
- Website: https://radio.withzero.xyz
- Canonical page: https://www.zero.xyz/c/radio-withzero-xyz-radio-withzero-earnings-balance-and-ledger-5b32efc6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ej8vCfkhzB8voOZhabRpV

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-withzero-earnings-balance-and-ledger-5b32efc6
```

Example prompt: What's my current earnings balance on the radio station, and can you show me all the tips and airtime charges in my ledger?

## When to prefer this

Use this endpoint when the broadcaster needs to check their current financial position on radio.withzero.xyz — either to decide whether to withdraw, to audit their tip income per show, or to reconcile airtime spending. It is the only endpoint that provides a full USDC ledger combining both inflows (tips) and outflows (airtime) in one response. Prefer this over the withdrawal endpoint when you only need to inspect balances without initiating a transfer.

## Known failure modes

- Unauthenticated request returns 401 — valid wallet credentials required
- No entries in ledger if broadcaster has never earned tips or spent airtime — returns empty entries array
- Network timeout if the platform is under load
- Balance may lag real-time if transactions are in-flight — availableUsdc accounts for pending withdrawals but not unconfirmed tips

## How this service works

Your earnings balance and ledger (broadcast tips, airtime spend).

## Output

Returns a JSON object containing: the broadcaster's wallet address, their settled USDC balance, their currently available (withdrawable) USDC balance, and an array of ledger entries — each with an entry type (e.g. 'tip' or 'airtime'), the USDC amount, the associated show ID (if any), and a creation timestamp.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "buyerId",
  "wallet",
  "balanceUsdc",
  "availableUsdc",
  "entries"
 ],
 "properties": {
  "wallet": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "description": "The wallet a withdrawal would pay out to, or null until you link one via POST /api/v1/buyer/links."
  },
  "buyerId": {
   "type": "string",
   "description": "Your buyer account — the key these earnings are held under, whichever channel you called on."
  },
  "entries": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "kind",
     "amountUsdc",
     "showId",
     "createdAt"
    ],
    "properties": {
     "kind": {
      "type": "string"
     },
     "showId": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "createdAt": {
      "type": "string"
     },
     "amountUsdc": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  },
  "balanceUsdc": {
   "type": "string",
   "description": "Settled earnings balance."
  },
  "availableUsdc": {
   "type": "string",
   "description": "Balance minus in-flight withdrawals — what you can withdraw now."
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/radio-withzero-xyz-radio-withzero-earnings-balance-and-ledger-5b32efc6/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)