{"protocolVersion":"0.3.0","name":"Crypto Microdata for Agents (x402)","description":"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.34","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"}}