{"uid":"cap_8mNim1pNjO-CSvVcSyz7g","slug":"kimchi-premium-api-x402-cd9e30a3","name":"Kimchi Premium API (x402)","description":"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.","url":"https://kr-x402-mvp.kgy5612.workers.dev/api/kimchi-premium?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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","properties":{"symbols":{"type":"string","examples":["BTC,ETH","BTC"],"description":"Comma-separated filter (default BTC,ETH)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"assets":[{"symbol":"BTC","upbit_krw":108533000,"global_usd":80867.7,"premium_pct_fx":1.15,"premium_pct_usdt":0.16},{"symbol":"ETH","upbit_krw":3162000,"global_usd":2356.1,"premium_pct_fx":1.15,"premium_pct_usdt":0.15}],"usdkrw":1326.8,"sources":["https://api.upbit.com","https://api.exchange.coinbase.com","https://api.kraken.com","https://www.bitstamp.net","https://open.er-api.com"],"updated_at":"2026-10-28T03:00:00Z","upbit_usdt_krw":1340}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MUQo_uxnC1QZ_5KZt4FEa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the kimchi premium — the price spread between Korean crypto exchanges and global markets — for BTC and/or ETH, paid per-call via x402 USDC on Base.","exampleAgentPrompt":"What's the current kimchi premium for BTC and ETH — how much more expensive are they on Korean exchanges like Upbit compared to global prices, and what's the USD/KRW rate right now?","exampleUseCases":[{"title":"Arbitrage opportunity scanner","prompt":"Check the kimchi premium for BTC and ETH and tell me if the spread vs global prices is large enough to consider a cross-exchange arbitrage trade right now."},{"title":"Korean market price divergence alert","prompt":"What's the current kimchi premium percentage for Bitcoin on Upbit compared to Coinbase and Kraken? I want to know both the FX-adjusted and USDT-adjusted spreads."},{"title":"Crypto trading bot enrichment","prompt":"Fetch the latest kimchi premium data for BTC so my trading bot can factor in the Korean market price divergence and the live USD/KRW exchange rate before placing any orders."}],"resultDescription":"A JSON object containing, for each requested symbol (default BTC, ETH): the Upbit KRW price, global USD price, premium percentage adjusted for FX, premium percentage vs USDT, plus the live USD/KRW rate, the Upbit USDT/KRW rate, source exchange URLs, and an updated_at timestamp.","failureModes":["Payment failure or missing x402 USDC payment header returns 402 Payment Required","Invalid or unsupported symbol in `symbols` param may return empty assets array or error","Upstream exchange APIs (Upbit, Coinbase, Kraken, etc.) temporarily unavailable causing stale or missing data","Malformed query string for symbols parameter returns 400 Bad Request","Network timeout to worker endpoint returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need real-time kimchi premium data (Korean vs global crypto price spread) without any API key setup, paying only $0.002 USDC per call via x402. Ideal for AI agents doing crypto arbitrage analysis, market monitoring, or needing a lightweight pay-per-use feed for BTC/ETH Korean market premiums without committing to a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:50.860Z","isFirstParty":false,"canonicalSlug":"kimchi-premium-api-x402-cd9e30a3"}