# Radio Zero Buyer Link Code Minter

> Radio Zero Buyer Link Code Minter 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-14).

Mints a single-use, 10-minute expiry code that links another purchasing channel to the current buyer account on Radio Zero.

## Facts

- Endpoint: POST https://radio.withzero.xyz/api/v1/buyer/link-codes
- Price: metered — billed by usage
- 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-zero-buyer-link-code-minter-58956491
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_J0zi3BjlYbkKAsKZnlSuu

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-zero-buyer-link-code-minter-58956491 -d '<json body>'
```

Example prompt: Generate a link code on my Radio Zero account so I can connect my other purchasing channel to it — I need the code before it expires in 10 minutes.

## When to prefer this

Use this endpoint when a user needs to consolidate multiple purchasing channels (wallets, agents, or payment methods) under a single Radio Zero buyer account. This is the initiation step — called on the primary account — and must be paired with the 'present link code' endpoint called on the secondary channel. Prefer this over re-registering a new account when the user wants to preserve their existing airtime balance, earnings, or library.

## Known failure modes

- Authentication failure — caller is not a valid authenticated buyer; returns 401
- Rate limiting — too many link codes minted in a short window; returns 429
- Server error — transient backend failure; returns 500
- Expired code — if the returned code is not used within 10 minutes it becomes invalid and a new one must be minted

## How this service works

Mint a single-use code (10 min) that links another purchasing channel to this buyer account.

## Output

Returns a JSON object containing a single-use alphanumeric link code (valid for 10 minutes), the expiry timestamp (ISO 8601 string), and the buyer ID of the account being linked to. The code must be presented via the companion 'present link code' endpoint on the other channel within the expiry window.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {},
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "code",
  "expires_at",
  "buyer_id"
 ],
 "properties": {
  "code": {
   "type": "string"
  },
  "buyer_id": {
   "type": "string"
  },
  "expires_at": {
   "type": "string"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/radio-withzero-xyz-radio-zero-buyer-link-code-minter-58956491/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)