Crypto Microdata for Agents (x402)

{
  "protocolVersion": "0.3.0",
  "name": "Crypto Microdata for Agents (x402)",
  "description": "AgentCash / x402 MCP clients: 1) mcp__agentcash__discover_api_endpoints(\"https://kr-x402-mvp.kgy5612.workers.dev\") 2) mcp__agentcash__check_endpoint_schema on the route you pick 3) mcp__agentcash__fetch (paid 200 arrives as {success,data}: read .data.verdict / .data.next). Task routing, start here: will this Base tx revert or drain me? /crypto/simulate $0.003 (cheaper pre-check: /crypto/decode-calldata $0.002). Who is crowded / liquidation risk? /crypto/liquidations?coin=BTC $0.003. ENS/basename to address: /crypto/ens?name= $0.002. Gas before a send: /crypto/base-gas $0.001 (multichain: /crypto/gas-price $0.002). Price: /crypto/prices $0.003. Should my agent buy this token? /crypto/token-risk $0.01. Upstream-named paths work too: /api/coingecko/price, /api/hyperliquid/funding, /api/tenderly/simulate, /api/kyberswap/quote, /api/goplus/token-security. If nothing here matches your task, switch origin. Pay-per-call crypto + Base on-chain microdata for trading/onchain agents. No API key, no signup: GET a route, read 402 PAYMENT-REQUIRED, sign USDC (EIP-3009) on Base, retry with PAYMENT-SIGNATURE. Funnel: 1) GET /crypto/ping ($0.001) to test your x402 client; 2) /crypto/base-gas ($0.001, cheapest live Base gas) before any Base tx, /crypto/gas-compare ($0.002: which EVM chain is cheapest right now, Base/Ethereum/Arbitrum/Optimism/Polygon/BSC gas in USD per transfer/ERC-20/swap, cheapest first; 2.5x cheaper than $0.005 gas-compare APIs), /crypto/prices ($0.003, median of 4-5 venues), /crypto/market-pulse ($0.004: prices+funding+kimchi+Fear&Greed+regime in one call); 3) /crypto/positioning?coin=BTC ($0.003: are longs or shorts crowded? open interest + change, long/short ratio, liquidations long vs short, taker flow, funding OKX+Hyperliquid, verdict LONGS_CROWDED..SHORT_SQUEEZE_RISK; replaces 3 separate $0.006-0.007 calls), /crypto/funding-signal ($0.006: cross-venue funding Hyperliquid+OKX+Gate+dYdX, signal EXTREME_LONG..EXTREME_SHORT, best funding-arb pair), /crypto/hl-book?coin=BTC and /crypto/hl-funding ($0.005) for perps; 4) /crypto/token-risk?address=0x... ($0.01) answers 'should my agent buy this Base token?' with verdict OK|CAUTION|AVOID, should_buy, can_sell, reasons, /crypto/erc20-balance?token=&wallet= ($0.003), /crypto/wallet-snapshot?wallet= ($0.003, ETH+USDC+gas readiness in one call), /crypto/eth-balance?wallet= ($0.002), /crypto/allowance?owner=&spender= ($0.002: ERC-20 approval check on Base, unlimited flag, exposure = min(allowance, balance), known-spender label, revoke calldata; pass amount= for can_spend; cheaper than $0.003 allowance APIs), /crypto/tx-status?hash=0x.. ($0.002: did this Base tx succeed, who paid whom how much USDC, confirmations; pass expect_to=&expect_usdc= to verify a payment), /crypto/candles?symbol=BTC&interval=1h ($0.002: OHLCV klines + EMA20/50, RSI14, ATR14, trend and pullback zone; Binance>OKX>Hyperliquid>Coinbase>Kraken fallback, 3.75x cheaper than $0.0075 candle APIs), /crypto/perp-movers ($0.002: whole-market Hyperliquid scanner, top gainers/losers, funding extremes, OI/volume leaders, breadth; replaces 7 ranking calls), /crypto/kimchi-premium ($0.002), /crypto/prediction-markets?q=bitcoin ($0.003: live Polymarket odds as implied probabilities, 24h volume, liquidity, 1d move; 2.5x cheaper than $0.0075 prediction-market APIs, 404 = no match = not charged), /crypto/market-risk ($0.002: is anything breaking? ONE 0-100 market-stress score low|moderate|elevated|high from 5 legs: stablecoin peg+flows, BTC move+perp breadth, leverage/funding extremes, BTC volatility, Fear&Greed; returns main_driver, action and suggested_max_leverage; covers derivatives+sentiment that stablecoin-only risk scores skip), /crypto/global-market ($0.002: total crypto market cap, 24h volume, BTC/ETH dominance, DeFi TVL, total stablecoin supply + 1d/7d flow, Fear&Greed and a risk_on/risk_off regime in ONE call; cheaper than $0.003 market-cap-only APIs), /crypto/eth-rpc ($0.002: keyless Ethereum mainnet JSON-RPC, same batch-10 rules, 5x cheaper than ~$0.01 mainnet RPC APIs), /crypto/base-rpc ($0.002: keyless Base JSON-RPC, GET or POST, batch up to 10 calls per payment, 7-RPC failover; 2.5x cheaper than $0.005 x402 RPC gateways, up to 25x cheaper batched), /crypto/swap-quote?from=USDC&to=WETH&amount=10 ($0.003: best-route Base swap quote over 100+ DEX pools, cost %, gas USD, verdict, and with wallet= a ready-to-sign tx + approval check; quote first instead of paying flat $0.05 swap execution fees), /crypto/x402-recommend?need= ($0.003: which x402 API should I pay for this task? ranked by real 24h settled buyers on x402scan + matching routes here, then hands off to x402-check; 3.3x cheaper than $0.01 recommenders), /crypto/x402-check?url= ($0.002: should my agent pay this x402 endpoint? live unpaid probe of ANY x402 URL: decodes the 402 quote, real USD price, network, USDC-or-not asset, payTo EOA/contract + its Base USDC balance, scheme, timeout, Bazaar schema, latency, risk flags, verdict SAFE_TO_PAY|CAUTION|AVOID and within_budget for max_usd=; live check, not stored evidence, and 5x cheaper than $0.01 endpoint-recommendation APIs), /crypto/x-search?q= ($0.003: live X/Twitter posts + sentiment signal, for agents that cannot read X), /crypto/tx-simulate?from=&to=&data= ($0.003: pre-sign Base tx simulation, will it revert + why, exact token/ETH balance changes per address, approvals granted, gas in USD, verdict SAFE_TO_SEND|CAUTION|WILL_REVERT; batch approve+swap in one call; 40% cheaper than $0.005 simulation APIs), /crypto/contract-info?address=0x.. ($0.002: what is at this address on Base/Ethereum? EOA vs contract vs 7702 wallet, ERC20/721/1155/Safe/proxy kind, token metadata, EIP-1967 implementation+admin, owner/renounced, risk flags; one call instead of three), /crypto/ens-resolve?name=vitalik.eth ($0.002: ENS + Basenames both ways, verified flag, profile records; 15x cheaper than $0.03 ENS APIs; alias /crypto/ens), /crypto/chain-rank ($0.003: which chain is growing or shrinking, 12 chains ranked by DEX volume + TVL momentum), /crypto/defi-tvl ($0.002: total + per-chain DeFi TVL with 1d/7d/30d flow, chain rank, protocol TVL, RISK_ON/OFF; one call instead of two $0.003 TVL/overview calls), /crypto/fear-greed ($0.001: Crypto Fear & Greed now + 30d history, 1d/7d/30d change, 7d/30d avg, streak, zone, contrarian signal; same price as bare-number F&G APIs, 5x cheaper than $0.005 ones), /crypto/stablecoin-peg ($0.001: is USDC/USDT/DAI on peg in bps, DEPEG alerts, stablecoin supply flow 1d/7d/30d = risk-on/off, Base supply). Every unpaid 402 also returns the accepts[] terms inline in the JSON body plus a free sample link. Try before you pay: add ?sample=1 to ANY paid route for a free static example of its exact JSON shape. Failed calls (4xx/5xx) are never charged (settlement only on 200). Every paid 200 carries a receipt.url (also X-Receipt-URL header): re-fetch that exact result free for 24h if your client drops the response. Free: /health, /openapi.json, /llms.txt, /catalog, /status.",
  "url": "https://kr-x402-mvp.kgy5612.workers.dev/mcp",
  "preferredTransport": "JSONRPC",
  "version": "0.6.50",
  "provider": {
    "organization": "Crypto Microdata for Agents",
    "url": "https://kr-x402-mvp.kgy5612.workers.dev/"
  },
  "documentationUrl": "https://kr-x402-mvp.kgy5612.workers.dev/llms-full.txt",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "payment": {
    "protocol": "x402",
    "version": 2,
    "network": "eip155:8453",
    "asset": "USDC",
    "payTo": "0xe4be4d0bd82d8e68203deff81f79ede0529f2617",
    "facilitator": "https://facilitator.payai.network",
    "never_charged": "4xx/5xx",
    "cheapest_first_call": "https://kr-x402-mvp.kgy5612.workers.dev/crypto/ping?echo=my-agent"
  },
  "skills": [
    {
      "id": "crypto_tx_simulate",
      "name": "/crypto/tx-simulate",
      "description": "before signing or broadcasting a tx: will it revert and why, exact token/ETH balance changes, approvals granted, gas in USD",
      "tags": [
        "simulate",
        "tx-simulate",
        "simulation",
        "revert-reason",
        "pre-sign",
        "transaction-simulation"
      ],
      "examples": [
        "https://kr-x402-mvp.kgy5612.workers.dev/crypto/tx-simulate?from=0xe4be4d0bd82d8e68203deff81f79ede0529f2617&to=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&data=0xa9059cbb000000000000000000000000a587d73489f8f09d1975f1ddbb1c61c93e8fa9d700000000000000000000000000000000000000000000000000000000000003e8"
      ],
      "price_usd": 0.003,
      "free_sample": "https://kr-x402-mvp.kgy5612.workers.dev/crypto/tx-simulate?sample=1"
    },
    {
      "id": "crypto_ens_resolve",
      "name": "/crypto/ens-resolve",
      "description": "before sending funds to a human-readable name, or to label a wallet: ENS / Basename to address and back, verified flag, profile records",
      "tags": [
        "ens",
        "ens-resolve",
        "ens-lookup",
        "reverse-ens",
        "basename",
        "basenames"
      ],
      "examples": [
        "https://kr-x402-mvp.kgy5612.workers.dev/crypto/ens-resolve?name=vitalik.eth"
      ],
      "price_usd": 0.002,
      "free_sample": "https://kr-x402-mvp.kgy5612.workers.dev/crypto/ens-resolve?sample=1"
    },
    {
      "id": "crypto_positioning",
      "name": "/crypto/positioning",
      "description": "before opening or adding to a leveraged perp: are longs or shorts crowded? open interest + 1h/4h/24h change, long/short account ratio, liquidations long vs short, taker buy/sell, funding (OKX + Hyperl",
      "tags": [
        "liquidations",
        "open-interest",
        "long-short-ratio",
        "funding-rates",
        "perps",
        "positioning"
      ],
      "examples": [
        "https://kr-x402-mvp.kgy5612.workers.dev/crypto/positioning?coin=BTC"
      ],
      "price_usd": 0.003,
      "free_sample": "https://kr-x402-mvp.kgy5612.workers.dev/crypto/positioning?sample=1"
    },
    {
      "id": "crypto_base_gas",
      "name": "/crypto/base-gas",
      "description": "right before sending any Base transaction",
      "tags": [
        "gas",
        "gas-oracle",
        "gas-price",
        "eip-1559",
        "fee-estimate",
        "maxFeePerGas"
      ],
      "examples": [
        "https://kr-x402-mvp.kgy5612.workers.dev/crypto/base-gas?gas_limit=21000"
      ],
      "price_usd": 0.001,
      "free_sample": "https://kr-x402-mvp.kgy5612.workers.dev/crypto/base-gas?sample=1"
    },
    {
      "id": "crypto_token_risk",
      "name": "/crypto/token-risk",
      "description": "before buying any Base token: should_buy / can_sell verdict",
      "tags": [
        "honeypot",
        "token-risk",
        "rug-check",
        "should-buy",
        "token-security",
        "token-verdict"
      ],
      "examples": [
        "https://kr-x402-mvp.kgy5612.workers.dev/crypto/token-risk?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
      ],
      "price_usd": 0.01,
      "free_sample": "https://kr-x402-mvp.kgy5612.workers.dev/crypto/token-risk?sample=1"
    },
    {
      "id": "crypto_swap_quote",
      "name": "/crypto/swap-quote",
      "description": "before any swap or token buy on Base: best route over 100+ DEX pools, all-in cost %, verdict, and with wallet= a ready-to-sign tx + approval check",
      "tags": [
        "swap-quote",
        "swap",
        "dex-aggregator",
        "best-price",
        "base",
        "dex"
      ],
      "examples": [
        "https://kr-x402-mvp.kgy5612.workers.dev/crypto/swap-quote?from=USDC&to=WETH&amount=10"
      ],
      "price_usd": 0.003,
      "free_sample": "https://kr-x402-mvp.kgy5612.workers.dev/crypto/swap-quote?sample=1"
    },
    {
      "id": "crypto_defi_tvl",
      "name": "/crypto/defi-tvl",
      "description": "where is DeFi money moving? total + per-chain TVL with 1d/7d/30d flow, chain rank/share, protocol TVL by slug, RISK_ON/RISK_OFF in one call",
      "tags": [
        "defillama",
        "tvl",
        "defi-tvl",
        "defi",
        "chain-tvl",
        "total-value-locked"
      ],
      "examples": [
        "https://kr-x402-mvp.kgy5612.workers.dev/crypto/defi-tvl?chain=Base"
      ],
      "price_usd": 0.002,
      "free_sample": "https://kr-x402-mvp.kgy5612.workers.dev/crypto/defi-tvl?sample=1"
    },
    {
      "id": "crypto_ping",
      "name": "/crypto/ping",
      "description": "first call: verify your x402 client works ($0.001)",
      "tags": [
        "x402-test",
        "payment-test",
        "ping",
        "test",
        "heartbeat",
        "x402"
      ],
      "examples": [
        "https://kr-x402-mvp.kgy5612.workers.dev/crypto/ping?echo=my-agent-1"
      ],
      "price_usd": 0.001,
      "free_sample": "https://kr-x402-mvp.kgy5612.workers.dev/crypto/ping?sample=1"
    }
  ],
  "discovery": {
    "x402": "https://kr-x402-mvp.kgy5612.workers.dev/.well-known/x402",
    "openapi": "https://kr-x402-mvp.kgy5612.workers.dev/openapi.json",
    "mcp": "https://kr-x402-mvp.kgy5612.workers.dev/mcp",
    "llms": "https://kr-x402-mvp.kgy5612.workers.dev/llms.txt",
    "llms_full": "https://kr-x402-mvp.kgy5612.workers.dev/llms-full.txt",
    "skill": "https://kr-x402-mvp.kgy5612.workers.dev/skill.md",
    "find": "https://kr-x402-mvp.kgy5612.workers.dev/find?q=",
    "info": "https://kr-x402-mvp.kgy5612.workers.dev/info"
  }
}