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 or Solana, priced per call, with signed receipts and automatic no-charge guarantees.

Status: free API, free previews, and the paid tier are live.

The short version

  • Currency: USD Coin (USDC) on Base mainnet or Solana mainnet, on-chain verified.
  • Price: from $0.02 per call. Credits are $0.01 each, 100 per US dollar. A corpus lookup costs 2 credits ($0.02), a computed verdict 10 ($0.10), cross-game synthesis 25 ($0.25).
  • One way to pay: a prepaid credit token, bought once, decremented per call.
  • Every paid response carries an Ed25519-signed receipt, and you are never charged for our failures.

How to pay: the credit token

Buy a bearer token once, then spend credits per call.

  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 or Solana.
  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.

Calling a /api/premium/* endpoint with no auth returns a 402 carrying the price and the quote endpoint, so an agent can discover pricing without documentation. Per-call settlement via payment headers is not offered; the credit token is the payment path. The machine-readable manifest lives at /.well-known/x402.json.

Premium endpoints

EndpointPriceReturns
/api/premium/economy-arbitrage-verdict10 credits ($0.10)Signed verdict on the widest sustained cross-market arbitrage in a tracked game economy (OSRS): the ranked table, depth evidence, and a risk flag. Free preview of the top pick at /api/preview/economy-arbitrage-verdict.
/api/premium/d2/breakpoint-verdict10 credits ($0.10)Reasoned Diablo 2 breakpoint verdict computed over PVPWire's independently compiled tables: the frame tier hit for a class, stat and current percent, every remaining threshold, and the ranked table of runewords, uniques and set items that close the gap. Free preview at /api/preview/d2/breakpoint-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. Legal contact: [email protected].