# Crypto Microdata for Agents – Swap Quote (x402)

> Crypto Microdata for Agents – Swap Quote (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-10-31).

Returns a multi-venue aggregated swap quote on Base (price, route, gas, min-out, verdict) for a token pair, optionally with ready-to-sign calldata.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/v1/swap-quote?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-microdata-for-agents-swap-quote-x402-0a9dda50
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4eLS70Z2P38ZceB5R56h2

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 crypto-microdata-for-agents-swap-quote-x402-0a9dda50
```

Example prompt: Get me a swap quote for 10 USDC to WETH on Base using the aggregated DEX router — include the best price, gas cost, and fill verdict.

## When to prefer this

Choose this endpoint when your agent needs a real-time, gas-adjusted, multi-venue swap quote on Base with a quality verdict — especially when you want calldata ready to sign without building your own aggregation layer. It is better than raw on-chain calls when you need cross-venue price comparison, gas estimation, and fill-quality guidance in a single pay-per-call request with no API key setup.

## Known failure modes

- Unsupported token symbol returns an error or empty route
- No liquidity path found between the requested pair
- Amount too small to cover gas may return negative net_out_usd
- Missing required query params (from, to, amount) returns 400
- x402 payment failure if USDC balance on Base is insufficient
- Stale or unavailable aggregator data may yield suboptimal routes

## 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

A JSON object containing: token-in and token-out metadata (symbol, address, decimals), number of route hops, chain, effective price, route venues, router address, source aggregator, gas cost in USD, L1 fee in USD, minimum output amount, net output in USD, a GOOD/OK/BAD verdict on fill quality, human-readable guidance, amount-in and amount-out in both native and USD units, and optionally ready-to-sign calldata when a wallet address is supplied.

## 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/crypto-microdata-for-agents-swap-quote-x402-0a9dda50/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)