# Crypto Microdata Recommend (x402)

> Crypto Microdata Recommend (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).

Recommends the best x402 pay-per-call endpoint for a given crypto/onchain data need, returning scored matches from local endpoints and the broader x402 ecosystem

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/crypto/x402-recommend?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-recommend-x402-85f4f256
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9WsQEsvmGJTIajsaTXlbd

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-recommend-x402-85f4f256
```

Example prompt: I need live BTC funding rates for my trading bot — can you find and recommend the best x402 endpoint for that, keeping the cost under $0.01 per call?

## When to prefer this

Use this endpoint when your agent needs to dynamically discover which x402 crypto microdata endpoint to call for a given task, rather than hardcoding a specific endpoint. Ideal for agents that handle diverse crypto data needs (gas, risk, balances, prices, funding, kimchi premium) and want to route intelligently based on cost and capability signals backed by live x402scan settlement evidence.

## Known failure modes

- Missing or empty 'need' query parameter returns an error or empty result
- No matching endpoint found if the requested data type is outside the indexed crypto domain
- Ecosystem data may be stale if x402scan settlement feed has a lag
- Price filter via max_usd may exclude all candidates if set too low
- Workers.dev endpoint may have cold-start latency on first request

## 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 recommendation object with: the best matching local endpoint URL and why it was chosen, a list of scored local candidates with match reasons and prices, a list of ecosystem alternatives discovered from x402scan with 24h transaction evidence (volume, unique buyers, tx count), a next-step check URL, and the timestamp of the recommendation.

## 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": [
      "need"
     ],
     "properties": {
      "need": {
       "type": "string",
       "examples": [
        "live btc funding rates",
        "twitter search",
        "llm inference"
       ],
       "maxLength": 200,
       "description": "Task in plain words (aliases q, task)"
      },
      "max_usd": {
       "type": "number",
       "examples": [
        0.01
       ],
       "description": "Optional max price per call in USD"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "here": [
   {
    "url": "https://kr-x402-mvp.kgy5612.workers.dev/crypto/x-search",
    "score": 6,
    "matched": [
     "twitter",
     "x"
    ],
    "price_usd": 0.003
   }
  ],
  "need": "twitter search",
  "next": [
   "/crypto/x402-check?url="
  ],
  "ecosystem": [
   {
    "title": "twit.sh - Plug AI agents into X",
    "origin": "https://x402.twit.sh",
    "matched": [
     "x"
    ],
    "evidence": {
     "source": "x402scan settled payments",
     "tx_24h": 480,
     "avg_paid_usd": 0.00561,
     "volume_usd_24h": 2.69,
     "unique_buyers_24h": 15
    },
    "check_url": "https://kr-x402-mvp.kgy5612.workers.dev/crypto/x402-check?url=https%3A%2F%2Fx402.twit.sh",
    "match_score": 1
   }
  ],
  "checked_at": "2026-10-30T06:30:00Z",
  "recommendation": {
   "url": "https://kr-x402-mvp.kgy5612.workers.dev/crypto/x-search",
   "why": "live X/Twitter posts + sentiment",
   "type": "here",
   "price_usd": 0.003
  },
  "evidence_source": "x402scan public.sellers.bazaar.list timeframe=24h (live)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-microdata-recommend-x402-85f4f256/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)