KODA

KODA Documentation

KODA is an x402 facilitator that validates API response quality before settling payments. Bad responses get rejected — buyers keep their funds.

What is KODA?

In the x402 protocol, a facilitator sits between buyers and providers. It verifies payment headers, holds funds during the request, and settles after the response. KODA adds a quality gate to this settlement step — it inspects the response and only settles if the data is actually useful.

Provider Quickstart

  1. 1
    Point your facilitator URL to KODA

    Set your x402 facilitator URL to https://x402.kodaoracle.com

  2. 2
    Install SDK middleware (optional)

    For full protection, install the KODA middleware to send response bodies for quality validation.

  3. 3
    Done

    KODA handles quality validation transparently at settle-time.

Buyer Quickstart

No changes needed. Use any x402 client library. If a provider uses KODA, quality validation happens transparently — you only pay for responses that pass the quality gate.

Querying a KODA-protected providerbash
# Standard x402 request — KODA works transparently
curl -H "X-Payment: <payment-header>" \
  https://provider-using-koda.com/api/v1/data

Facilitator API

Free x402 protocol endpoints: supported, verify, settle

Trust API

Paid endpoints for trust scores, agent verification, monitoring

Provider Middleware

Captures response bodies for quality gate validation — Hono & Express