# radio.withzero.xyz Earnings Withdrawal

> radio.withzero.xyz Earnings Withdrawal 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).

Withdraw accumulated USDC earnings (from broadcast tips) from your radio station balance to your crypto wallet on-chain.

## Facts

- Endpoint: POST https://radio.withzero.xyz/api/v1/withdrawals
- 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-earnings-withdrawal-0f353c2d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZIV4zTHwekbzFwJocJjVC

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-earnings-withdrawal-0f353c2d -d '<json body>'
```

Example prompt: Withdraw all my earnings from my radio.withzero.xyz station balance to my wallet right now.

## When to prefer this

Use this endpoint when an agent needs to move USDC earnings from the radio.withzero.xyz platform balance out to an on-chain wallet. It is the only withdrawal mechanism for this platform. Prefer specifying amountUsdc for partial withdrawals; omit it to sweep the full balance. Always supply a unique Idempotency-Key to prevent accidental double-payouts.

## Known failure modes

- Missing or duplicate Idempotency-Key header — request rejected to prevent double withdrawal
- Requested amountUsdc exceeds available balance — insufficient funds error
- Invalid amountUsdc format (doesn't match pattern ^\d+(\.\d{1,6})?$) — validation error
- No earnings available to withdraw — zero balance error
- On-chain transaction failure — network or wallet address issue

## How this service works

Withdraw your earnings to your wallet. Requires an Idempotency-Key header.

## Output

Returns a withdrawalId (unique identifier for this withdrawal), the amountUsdc withdrawn, and a txRef (on-chain transaction reference/hash) confirming the payout was initiated on-chain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "amountUsdc": {
   "type": "string",
   "pattern": "^\\d+(\\.\\d{1,6})?$",
   "description": "Amount to withdraw in USDC. Omit to withdraw the full available balance."
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "withdrawalId",
  "amountUsdc",
  "txRef"
 ],
 "properties": {
  "txRef": {
   "type": "string",
   "description": "On-chain transaction reference of the payout."
  },
  "amountUsdc": {
   "type": "string"
  },
  "withdrawalId": {
   "type": "string"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/radio-withzero-xyz-earnings-withdrawal-0f353c2d/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)