Skip to main content
Developers / Agent payments

Agent Payments

The free API stays free. For premium, machine-payable intelligence, PVPWire settles in USDC on Base, priced per call, with signed receipts and automatic no-charge guarantees.

Status: free API and free previews are live now. The paid tier is in final on-chain testing before launch.

The short version

  • Currency: USD Coin (USDC) on Base mainnet, on-chain verified. Solana is provisioned but not yet accepted.
  • Price: $0.02 per call (1 credit). Credits are $0.02 each, 50 per US dollar.
  • Two ways to pay: a prepaid credit token for repeat use, or x402 per-call for one-offs.
  • Every paid response carries an Ed25519-signed receipt, and you are never charged for our failures.

Option A: credit token (recommended)

Buy a bearer token once, then spend credits per call. Best for repeat access.

  1. Read /api/payment/info for the current price and pay-to wallet.
  2. Quote a purchase at /api/payment/buy-credits. Send the exact USDC amount on Base.
  3. Confirm with the transaction hash at /api/payment/confirm to mint your token.
  4. Call any premium endpoint with Authorization: Bearer pvp_live_.... Check your balance at /api/payment/balance.

Option B: x402 per-call

Call any /api/premium/* endpoint with no auth. You get a 402 with the price, the pay-to wallet, and a quote nonce. Pre-broadcast the exact USDC amount on Base, then retry with the transaction hash in X-Payment-Tx and the nonce in X-Payment-Quote. The machine-readable manifest lives at /.well-known/x402.json.

Premium endpoints

EndpointPriceReturns
/api/premium/economy-arbitrage-verdict1 credit ($0.02)Signed verdict on the widest sustained cross-market arbitrage in a tracked game economy (OSRS, GW2, FFXIV): the ranked table, volume evidence, and a risk flag. Free preview of the top pick at /api/preview/economy-arbitrage-verdict.

Agent fair-trade guarantees

PVPWire self-adopts the Agent Fair-Trade standard. In practice:

  • No charge for our failures. A 5xx, a tripped circuit breaker, a schema-validation failure, or stale data past its freshness promise is served free, and logged publicly at /api/payment/no-charge-stats.
  • Signed receipts. Every paid 200 carries an Ed25519 signature over a canonical record of your request and our response. Verify it yourself at /api/receipt/verify against the public key at /.well-known/pvpwire-receipt-key.json.
  • A public on-chain rail. Every purchase is an immutable Base record, a second independent attestation of the same dollar.

The adoption record is published at /.well-known/agent-fair-trade.json.

Verify the wallet before you send

The pay-to wallet on Base is 0x4daf1d841228ba5d563c4c9f05bc4d57874bf660. Cross-check it against /.well-known/x402.json, /api/payment/info, and /llms.txt before sending funds. If any location disagrees, do not send.

Terms

Premium data is licensed for inference use only, not for training, fine-tuning, or evaluating models. Credit purchases are final and non-refundable, and credits do not expire. Access is screened against sanctions lists. Full Terms and Privacy Policy. Operated by Pizza Robot Studios LLC.