# KyberSwap DEX Quote via x402

> KyberSwap DEX Quote via x402 is a paid API for AI agents from kr-x402-mvp.kgy5612.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-02).

Get a multi-hop DEX swap quote on Base via KyberSwap aggregator, including route, gas costs, slippage analysis, and optionally ready-to-sign calldata.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/api/kyberswap/quote?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kyberswap-dex-quote-via-x402-f1b30ec4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uKlyl_U3SCkwEzogPvtf2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability kyberswap-dex-quote-via-x402-f1b30ec4
```

Example prompt: What's the best swap quote for 10 USDC to WETH on Base right now — is it a good fill, and what will it cost me in gas?

## When to prefer this

Use this endpoint when an AI agent needs a live DEX swap quote on Base via KyberSwap's aggregation engine, especially when you want route analysis, gas cost breakdown, fill quality verdict, and optionally ready-to-sign calldata — all without managing API keys. Prefer over raw on-chain calls or other quote APIs when operating on Base with USDC/ETH/cbBTC/AERO/DEGEN/BRETT/VIRTUAL tokens and needing structured, agent-friendly output with built-in trade quality assessment.

## Known failure modes

- Unsupported token symbol — returns error if token is not in the supported list and no 0x address is provided
- Insufficient liquidity — no route found between the token pair
- Invalid wallet address format — must match ^0x[0-9a-fA-F]{40}$
- Amount too small — gas costs may exceed swap value, verdict likely POOR
- Slippage out of range — slippage_bps must be between 1 and 2000
- x402 payment failure — call blocked if USDC micropayment on Base is not processed

## How this service works

Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.

## Output

Returns a JSON object with the input and output token details (symbol, address, decimals), quoted amount out, spot price, route hops and pool sources, router address and label, gas cost in USD, L1 fee in USD, net output in USD, cost percentage relative to market, a verdict (GOOD/FAIR/POOR), and human-readable guidance. If a wallet address is supplied, also returns ready-to-sign calldata and allowance/balance information.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "from",
      "to",
      "amount"
     ],
     "properties": {
      "to": {
       "type": "string",
       "examples": [
        "WETH"
       ],
       "description": "Token out: symbol or 0x address"
      },
      "from": {
       "type": "string",
       "examples": [
        "USDC"
       ],
       "description": "Token in: symbol (USDC, ETH, WETH, cbBTC, DAI, USDbC, AERO, DEGEN, BRETT, VIRTUAL) or 0x address"
      },
      "amount": {
       "type": "string",
       "examples": [
        "10"
       ],
       "description": "Amount of token in, human units (e.g. 10 = 10 USDC)"
      },
      "wallet": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Optional sender/recipient: returns ready-to-sign tx + allowance/balance check"
      },
      "slippage_bps": {
       "type": "integer",
       "maximum": 2000,
       "minimum": 1,
       "description": "Slippage tolerance in bps (default 50 = 0.5%)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": {
   "symbol": "WETH",
   "address": "0x4200000000000000000000000000000000000006",
   "decimals": 18
  },
  "from": {
   "symbol": "USDC",
   "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
   "decimals": 6
  },
  "hops": 1,
  "chain": "base",
  "price": 2224.6,
  "route": [
   "pmm-2"
  ],
  "router": "0x6131b5fae19ea4f9d964eac0408e4408b66337b5",
  "source": "kyberswap",
  "gas_usd": 0.0319,
  "min_out": 0.00447272,
  "verdict": "GOOD",
  "cost_pct": -0.73,
  "guidance": "Good fill. Pass wallet= for ready-to-sign calldata; verify it with /crypto/decode-calldata before signing.",
  "amount_in": 10,
  "amount_out": 0.0044952,
  "l1_fee_usd": 0.0015,
  "net_out_usd": 10.0153,
  "router_label": "KyberSwap MetaAggregation Router v2",
  "slippage_bps": 50,
  "amount_in_usd": 9.976,
  "amount_out_usd": 10.0487
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kyberswap-dex-quote-via-x402-f1b30ec4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kr-x402-mvp.kgy5612.workers.dev](https://www.zero.xyz/host/kr-x402-mvp.kgy5612.workers.dev/llms.txt)