API-Preise & x402 Pay-per-Use

DEADBOX ist bis zu einem grosszuegigen Tageskontingent kostenlos — nur Heavy User zahlen ueberhaupt, und sie zahlen nur fuer das, was sie tatsaechlich nutzen. Keine Monatsabos, keine Kreditkarten-Paywall. Overage laeuft ueber x402, den HTTP 402 Payment Required-Standard auf Basis von Stablecoin-Transfers.

Tageskontingent-Tiers

Anonym (kein Header): 500 Calls/Tag, gratis. Free-Key: 2 000 Calls/Tag, gratis. Premium (verifizierter uDEAD-Holder >= 0,1% Supply): 50 000 Calls/Tag, gratis. Pay-per-Use: kein Tageslimit — jeder Call nach Aufbrauchen des Free-Kontingents bucht 0,0001 USD von deinem Prepaid-Guthaben ab (10 000 Calls pro $1). Resets erfolgen um 00:00 UTC.

Warum x402?

x402 ist eine kleine Spezifikation auf HTTP 402, mit der Server sagen koennen 'zahl $X um weiterzumachen' und Clients automatisch ueber On-Chain-Stablecoin-Transfers bezahlen — keine API-Key-Dashboards, keine Kreditkartenformulare, kein Subscription-Lock-in. Zahl $1 in USDC auf Base und bekomm 10 000 zusaetzliche Calls. Zahl nichts, bekomm nichts extra. Settlement in Sekunden.

Der Ablauf

1) Du laeufst gegen eine Quota-Wall und der Server antwortet mit 402 inklusive JSON-Body, der das Asset (USDC), Netzwerk (Base), die payTo-Adresse und den Preis pro Call beschreibt. 2) Dein Client schickt USDC an diese Adresse und POSTet den Tx-Hash + die Key-publicId an /api/sessions/prepay. 3) Ein Hintergrund-Verifier bestaetigt den On-Chain-Transfer und schreibt das Prepaid-Guthaben des Keys gut. 4) Folgerequests funktionieren wieder und buchen still vom Guthaben ab, bis es leer ist.

Die 402-Response entschluesseln

Body-Form: { x402Version: 1, error: 'payment_required', errorMessage: '…', accepts: [ { scheme: 'exact', network: 'base', asset: '0x833589fc…', assetSymbol: 'USDC', maxAmountRequired: '0.0001', payTo: '0x…', description: '…', docs: '…' } ] }. Das accepts-Array kann mehrere Optionen (verschiedene Chains/Assets) auflisten, wenn das Protokoll waechst. Heute wird nur USDC auf Base unterstuetzt.

json
HTTP/1.1 402 Payment Required
Content-Type: application/json

{
  "x402Version": 1,
  "error": "payment_required",
  "errorMessage": "Daily quota exhausted. Top up via x402 to continue.",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "assetSymbol": "USDC",
      "maxAmountRequired": "0.0001",
      "payTo": "0xd1Df5a16e1b19De2997828eDfD457237F281412F",
      "description": "DEADBOX API — per-call price (USD)",
      "docs": "https://deadbox.rip/de/learn/wiki/developers/api-pricing"
    }
  ]
}

On-Chain-Prepayment registrieren

Nach dem USDC-Transfer schicke den Tx-Hash + deine Wallet + den Betrag an /api/sessions/prepay. Der Verifier bestaetigt ihn innerhalb von ~60 Sekunden und schreibt dem Key gut.

bash
# 1. Schicke USDC auf Base an die payTo-Adresse aus der 402-Antwort.
#    Jede Wallet geht — Metamask, viem, ethers, cast.
# 2. Registriere den Tx bei der API.
curl -X POST https://api.deadbox.rip/api/sessions/prepay \
  -H 'Content-Type: application/json' \
  -d '{
    "apiKeyPublicId": "8f3a1c0d",
    "txHash": "0xabc…",
    "payerAddress": "0xdeineWallet…",
    "amountUsd": 1.00
  }'
# → { id, txHash, amountUsd, verified: false, message: "pending_verification" }
# Der Key-Saldo aktualisiert sich innerhalb von ~60s, sobald der Verifier den On-Chain-Transfer bestaetigt.