[Koda]

KODA Documentation

KODA is a DeFi oracle and x402 facilitator. It finds yield, scores risk, and settles payments with a quality gate that rejects bad data.

What is KODA?

KODA does three things:

  • x402 Facilitator — Free payment settlement with a quality gate. Verifies payment headers, inspects response quality, settles or rejects. Bad data = buyer keeps USDC.
  • DeFi Intelligence — Paid x402 endpoints for yield pool discovery with algorithmic risk scoring, LLM risk assessments, and token swaps with safety pipeline.
  • DeFi Execution — ACP offerings for token swaps, deposits/withdrawals via Aave V3, Morpho vaults, and Avantis (~12% APY), and yield discovery. Agents send tokens, KODA executes, output returns via ACP.

For Providers (Facilitator)

  1. 1
    Point your facilitator URL to KODA

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

  2. 2
    Install middleware (optional)

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

  3. 3
    Done

    KODA handles quality validation transparently at settle-time.

For Agents (x402)

Query yield pools via x402. Pay per query in USDC — no API keys, no subscriptions.

Query yields via x402bash
# Get Base yield pools with risk scoring — $0.05
curl "https://x402.kodaoracle.com/api/v1/yields?token=USDC&maxRisk=low" \
  -H "Payment-Signature: <base64-payment>"

Facilitator API

Free x402 protocol endpoints: supported, verify, settle with quality gate

DeFi API

Paid endpoints for yield discovery, risk scoring, token swaps, and ACP execution

Provider Middleware

Captures response bodies for quality gate validation — Hono & Express