Bemessene Routen und Zahlungsantworten

Ressourcenpreise, Abrechnungsmodi und die eigene 402-Antwortform.

Zuletzt aktualisiert: 30.09.2026

Aktueller Abrechnungsstand

Alle acht Datenrouten laufen derzeit auf Owner-Entscheidung in observe. Die erzeugte Inventur unten liest die tatsächlichen Handler-Wrapper und die Konfiguration dieser App-Instanz. Sie zeigt ausgewiesene Preise und bedeutet keine aktive Abrechnung. GET und POST desselben Pfads erscheinen gemeinsam. Datenroutenzugriff verwendet die bestehende read-Berechtigung, auch wenn die Abrechnung aktiviert wird.

Antwort-Header

  • X-Credits-Price weist Credits pro Aufruf aus.
  • X-Payment-Notice erklärt observe_mode_no_charge, enforcement_pending, terms_required oder billing_unavailable.
  • X-Credits-Charged und X-Credits-Remaining beschreiben einen abgerechneten Aufruf.
  • X-Credits-Refunded meldet gegebenenfalls eine Erstattung.

402-Antwort

Bei unzureichendem Guthaben eines bemessenen Datenaufrufs enthält die Antwort x402Version: 1 und eine accepts-Liste mit scheme ftsobest-prepaid-router. Sie beschreibt unseren Prepaid-Ablauf und ist keine exact-Zahlungsanweisung. maxAmountRequired ist 0; fordere ein echtes Angebot am Topup-Endpunkt an. Zahle nicht null und leite keinen Betrag aus diesem Feld ab. Das extra-Objekt verweist auf den Ablauf und enthält den USD-Anker. Browser-Sessions können zusätzlich topupPage erhalten. Anonymes Enforcement ist derzeit ausstehend und darf nicht als aktive Abrechnung beschrieben werden.

{
  "x402Version": 1,
  "error": "insufficient_credits",
  "code": "insufficient_credits",
  "accepts": [
    {
      "scheme": "ftsobest-prepaid-router",
      "network": "flare",
      "maxAmountRequired": "0",
      "extra": {
        "flow": "challenge -> token -> topup(authorization, asset optional) -> router.pay(tx) -> confirm(txHash) -> retry with Bearer"
      }
    }
  ]
}

Dies ist eine gekürzte Antwortform, kein vollständiges Schema. Fehlende Abo-Kapazität verwendet stattdessen code slot_required oder insufficient_credits mit purchase sowie buyEndpoint-/topupEndpoint-Informationen; dieselbe accepts-Antwortform wird dort nicht zugesichert.

Datenroute lesen

curl -i 'https://ftso.app/api/ftso/analytics/overview?chain=flare' \
  -H 'authorization: Bearer fbx_READ_TOKEN'

Die Referenz der Operationen beschreibt Verwaltungs-APIs; Aufladungen erklären die Finanzierung des Guthabens.

Bemessene Datenrouten

  • GET /api/ftso/analytics/board — ftso-analytics: 1 Credits pro Aufruf; Scope: read; Modus: observe.
  • GET /api/ftso/analytics/movers — ftso-analytics: 1 Credits pro Aufruf; Scope: read; Modus: observe.
  • GET /api/ftso/analytics/overview — ftso-analytics: 1 Credits pro Aufruf; Scope: read; Modus: observe.
  • GET /api/ftso/analytics/volatility — ftso-analytics: 1 Credits pro Aufruf; Scope: read; Modus: observe.
  • GET /api/intelligence/trust-radar — trust-radar: 5 Credits pro Aufruf; Scope: read; Modus: observe.
  • GET/POST /api/providers/{chain}/rewards — providers-rewards: 2 Credits pro Aufruf; Scope: read; Modus: observe.
  • GET /api/rewards-intelligence/external-rewards/scan — rewards-intelligence-scan: 10 Credits pro Aufruf; Scope: read; Modus: observe.
  • GET /api/rewards-intelligence/reports — rewards-intelligence-reports: 10 Credits pro Aufruf; Scope: read; Modus: observe.