# Relaystation

Pay-per-call API platform for AI agents and developers. Prepaid; no monthly fees, no subscription.

## Baton — the live product

A baton is a prepaid storage object configured along five independent groups. Pick the values that fit your use, pay once at create, draw down the prepaid quotas until expiry.

- Write behavior — single object, append, append hash-chained (tamper-evident, auto-witnessed), or overwrite.
- Capacity — size (storage), duration (validity), egress (read budget). A single write over 3 MB uploads via a presigned URL the create returns.
- Sharing — collaborator tokens (up to 100 per baton; each carries a read/write/read_write scope, optional read cap, optional expiry).
- Lifecycle — burn-after-reading (delete once every token read cap is consumed) and disposal (soft delete with grace, or hard delete).
- Trust — document-witness: Relaystation signs the content hash and keeps the signed record 7 years; verify offline against the published key.

Five named preconfigs are fast-start prefills (not the organizing principle — every value stays configurable on create):

- Drop — store a file (single object, multi-read until expiry).
- Pass — share a file (single object + a read-capped token; burns once consumed).
- Scratchpad — collaborate (append log + collaborator tokens).
- Checkpoint — save state (overwrite; replace the snapshot as you go).
- Ledger — audited ledger (append, hash-chained; tamper-evident; auto-witnessed).

One engine-computed quote is the published price — the engine quote of the shape, frozen at create. No catalog prices, no tiers as priced SKUs. Universal network-minimum floor of $0.001 (gas-cost).

## Discovery — start here

GET /v1/baton/system/info — agent-facing system descriptor (the five-group model, preconfigs, payment modes, merchant wallet, endpoint roster).
GET /v1/baton/prices — the named preconfigs and their default shapes (fast-start prefills).
POST /v1/baton/quote — public price-of-record for any baton shape (a preconfig ref or a custom shape).
GET /llms-full.txt — long-form spec with every endpoint, the x402 wire, the trust model.
GET /openapi.json — OpenAPI 3.1.

## The lodestone path (no account)

POST /v1/baton with X-Payment header (base64 EIP-3009 USDC or EURC signature, x402 v2) — one HTTPS call carries payload + payment; the wallet IS the identity; no signup needed.

## Baton endpoints (summary; /llms-full.txt has the full set)

POST /v1/baton — create. Billable.
GET  /v1/baton/{id} — read (owner) or /v1/baton/{tokenId} (token-addressed).
POST /v1/baton/{id} — write/append.
GET  /v1/baton/{id}/entries — paginated entries.
POST /v1/baton/{id}/add — buy another tier of the same preset.
POST /v1/baton/{id}/extend — buy à-la-carte dimensions.
DELETE /v1/baton/{id} — soft-delete + scheduled purge.
GET/POST /v1/baton/{id}/meta — read or mutate metadata.
POST /v1/baton/{id}/tokens — mint a collaborator token.
POST /v1/baton/{id}/trust/document-witness — freeze + sign.
POST /v1/baton/{id}/trust/verify-chain — verify chained-hash integrity.
POST /v1/baton/{id}/trust/challenge — public, free; match a candidate to a witnessed baton.
GET  /v1/baton/{id}/trust/proof — public, free; retrieve the signed attestation.

## Auth

- x402 EIP-3009 USDC or EURC payment in `X-Payment` header (lodestone — no account).
- API key in `Authorization: Bearer rs_live_...` (signup at app.relaystation.ai).
- Wallet JWT (challenge + verify at /v1/auth/challenge + /v1/auth/verify).

## MCP

POST /mcp — JSON-RPC over HTTP. Tools: baton.prices (the preconfigs + default shapes), baton.quote (price a shape), and the Courier communication tools (ask_operator / notify_operator / message_agent / …).
GET /.well-known/mcp.json — MCP advertisement.

## Related Relaystation MCPs

Relaystation runs several focused product MCPs that share one balance and one API key.
Add the one you need to your MCP host with your rs_live_* key as a ?key= query parameter.

- Baton — prepaid shared storage, hash-chained ledgers, collaborator tokens, document-witness.
  MCP: https://baton.relaystation.ai/mcp   Docs: https://relaystation.ai/docs/baton
- Courier — agent↔human/agent messaging (Telegram, email, SMS) + agent-to-agent mailboxes.
  MCP: https://api.relaystation.ai/mcp   Docs: https://courier.relaystation.ai/docs

## Docs

https://relaystation.ai/api-reference