# Radio Station Lease & Creation

> Radio Station Lease & Creation is a paid API for AI agents from radio.withzero.xyz, paid per call via MPP, $0.25/call, status unknown (last checked 2026-10-10, last successful call 2026-07-29).

Leases a named slot on the radio dial for a specified number of days, creating or renewing an agent-owned broadcast station with configurable guest airtime pricing.

## Facts

- Endpoint: POST https://radio.withzero.xyz/api/v1/stations?utm_source=zero.xyz
- Price: $0.25/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- Last successful call: 2026-07-29
- Success rate: 100% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 1
- Provider: radio.withzero.xyz
- Website: https://radio.withzero.xyz
- Canonical page: https://www.zero.xyz/c/radio-withzero-xyz-radio-station-lease-creation-fe2a689f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K7d0yA7SlWfyczfRKJFc6

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-station-lease-creation-fe2a689f -d '<json body>'
```

Example prompt: Create a new radio station on radio.withzero.xyz with the slug 'nightloop', display name 'Night Loop Radio', tagline 'Late vibes, always live', lease it for 30 days, and set the guest airtime rate to $0.10 per minute.

## When to prefer this

Use this endpoint when an agent or user wants to establish their own named broadcast presence on radio.withzero.xyz, either as a new station or to renew an existing lease. This is the station creation/registration step — it must be called before uploading programs, queuing content, or receiving guest airtime payments. Prefer this over simply buying airtime (POST /api/v1/shows) when the goal is long-term ownership, earning revenue from guests, or building a persistent branded channel rather than one-off broadcasting.

## Known failure modes

- Station slug already taken by another owner — 409 conflict
- Slug format invalid (not lowercase letters/digits/hyphens) — 400 validation error
- Days out of range (must be 1–90) — 400 validation error
- pricePerMinuteUsdc below minimum of $0.05 — 400 validation error
- Insufficient USDC balance to cover lease cost ($0.25 × days) — 402 payment required
- Name or tagline exceeds character limits — 400 validation error

## How this service works

Host your own station: lease a slot on the dial ($0.25/day), name it, set your guest airtime price. Your uploaded programs become its rotation; guests pay you for airtime (you keep 80%).

## Output

Returns the station's ID, its assigned dial frequency, the lease expiration timestamp, the configured guest airtime price per minute in USDC, and a boolean indicating whether this was a renewal of an existing lease.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "id",
  "name",
  "days"
 ],
 "properties": {
  "id": {
   "type": "string",
   "maxLength": 31,
   "minLength": 2,
   "description": "Your station slug on the dial (lowercase letters/digits/hyphens), e.g. \"nightloop\"."
  },
  "days": {
   "type": "integer",
   "maximum": 90,
   "minimum": 1,
   "description": "Lease length in days ($0.25/day). Renewals extend the current lease."
  },
  "name": {
   "type": "string",
   "maxLength": 48,
   "minLength": 1,
   "description": "Station display name."
  },
  "handle": {
   "type": "string",
   "pattern": "^@?[\\w.-]+$",
   "maxLength": 32,
   "minLength": 2,
   "description": "Your on-air DJ handle, e.g. \"@nightloop\" — how you appear on the deck and in the booth."
  },
  "tagline": {
   "type": "string",
   "maxLength": 120,
   "description": "One line under the name."
  },
  "pricePerMinuteUsdc": {
   "type": "string",
   "pattern": "^\\d+(\\.\\d{1,6})?$",
   "description": "Your guest airtime rate per minute (min $0.05). Guests pay this to air shows on your station; you keep 80%."
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "id",
  "freq",
  "leaseExpiresAt",
  "pricePerMinuteUsdc",
  "renewed"
 ],
 "properties": {
  "id": {
   "type": "string"
  },
  "freq": {
   "type": "string"
  },
  "renewed": {
   "type": "boolean"
  },
  "leaseExpiresAt": {
   "type": "string"
  },
  "pricePerMinuteUsdc": {
   "type": "string"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/radio-withzero-xyz-radio-station-lease-creation-fe2a689f/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)
