{"uid":"cap_FNbiw5n3SJH-QNVx9TqWT","slug":"kr-rates-fx-kimchi-premium-korean-crypto-fx-data-6a0f2faa","name":"KR Rates FX - Kimchi Premium & Korean Crypto FX Data","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/v1/kr-rates-fx-v1?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_V3_M2_9NuMnfBOuyK117J","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 Korea-USD FX rate, BTC/ETH prices on Upbit in KRW, global USD prices, and kimchi premium percentages (both FX-adjusted and USDT-adjusted).","exampleAgentPrompt":"What's the kimchi premium right now for BTC and ETH — show me the Upbit KRW price, global USD price, and both the FX-adjusted and USDT-adjusted premium percentages.","exampleUseCases":[{"title":"Kimchi premium arbitrage check","prompt":"Check the current kimchi premium for BTC — what's the price gap between Upbit in Korea and the global USD price, and how big is the premium in percentage terms both FX-adjusted and USDT-adjusted?"},{"title":"Korean FX rate for stablecoin trader","prompt":"What's the current USD/KRW exchange rate and how does the Upbit USDT/KRW rate compare? I want to understand the FX spread for moving stablecoins in and out of Korean exchanges."},{"title":"Multi-coin Korean price monitor","prompt":"Pull the latest Upbit prices and global USD prices for BTC and ETH so I can track the kimchi premium for both coins and see if there's a meaningful spread developing."}],"resultDescription":"A JSON object with an 'assets' array (one entry per requested symbol) each containing Upbit KRW price, global USD price, FX-adjusted kimchi premium %, and USDT-adjusted kimchi premium %; plus the USD/KRW FX rate, Upbit USDT/KRW rate, data source URLs, and an updated_at timestamp.","failureModes":["Upstream exchange API unavailability (Upbit, Coinbase, Kraken, Bitstamp) causes stale or missing prices","FX rate provider (open.er-api.com) downtime causes FX-adjusted premium to fail","Invalid or unrecognized symbol in 'symbols' query param returns empty or partial asset list","x402 payment failure (insufficient USDC balance or wrong network) blocks access with HTTP 402","Cold-start latency on Cloudflare Workers may cause occasional timeout on first request"],"whenToPreferThis":"Use this endpoint when you specifically need Korean crypto exchange prices (Upbit KRW), the kimchi premium (both FX and USDT adjusted), or the USD/KRW FX rate in a single call — especially for arbitrage monitoring or Korea-specific market analysis. Prefer this over generic crypto price APIs when the Korea-vs-global price gap is the core signal needed. No API key required; pay $0.002 USDC per call via x402 on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:50.303Z","isFirstParty":false,"canonicalSlug":"kr-rates-fx-kimchi-premium-korean-crypto-fx-data-6a0f2faa"}