{"uid":"cap_P2VPQeXTf9P8DEM6JMa68","slug":"upbit-kimchi-premium-data-via-x402-2abd73a0","name":"Upbit Kimchi Premium Data via 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/v1/nofx/upbit/hot?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_0QG30KUzS2VSvn0LmXims","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 live kimchi premium percentages for BTC and ETH by comparing Upbit KRW prices to global USD prices, plus USD/KRW FX rate, paid per-call via x402 USDC.","exampleAgentPrompt":"What's the current kimchi premium for BTC and ETH — show me the Upbit KRW prices, the global USD prices, and the premium percentage both FX-adjusted and USDT-adjusted, along with the USD/KRW rate?","exampleUseCases":[{"title":"Kimchi premium arbitrage alert","prompt":"Check the current kimchi premium for BTC on Upbit vs global exchanges — if it's above 2%, flag it as an arbitrage opportunity and tell me the exact Upbit KRW price, the global USD price, and the USD/KRW rate you used."},{"title":"Korea crypto market overview for trading bot","prompt":"Fetch me the live Upbit prices and kimchi premium percentages for both BTC and ETH so my trading bot can decide whether cross-border price gaps are worth acting on right now."},{"title":"Monitor ETH Korea premium for research","prompt":"What's the kimchi premium on ETH right now? I want the Upbit KRW price, the global USD reference price, and both the FX-adjusted and USDT-adjusted premium percentages."}],"resultDescription":"A JSON object with an 'assets' array where each entry contains the symbol, Upbit KRW price, global USD price, FX-adjusted kimchi premium %, and USDT-adjusted kimchi premium %. Also includes the USD/KRW FX rate, Upbit's implied USDT/KRW rate, data sources list, and an updated_at timestamp.","failureModes":["x402 payment failure if USDC balance insufficient or Base network congestion","Upbit API unavailable causing stale or missing KRW prices","FX rate API (open.er-api.com) rate limit or outage resulting in no USD/KRW data","Invalid or unsupported symbol in 'symbols' query param returning empty assets array","Worker timeout if multiple upstream APIs are slow simultaneously"],"whenToPreferThis":"Choose this endpoint when you specifically need Korea Upbit KRW pricing and the kimchi premium differential vs global exchanges (Coinbase, Kraken, Bitstamp). It aggregates multi-venue global prices and FX rates into a single premium calculation you'd otherwise have to build yourself. Ideal for arbitrage monitoring, cross-border trading strategies, or any agent that needs to know whether Korean crypto prices are significantly above global prices. Prefer over general price APIs when the Korea-specific premium is the primary signal you need.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:14.953Z","isFirstParty":false,"canonicalSlug":"upbit-kimchi-premium-data-via-x402-2abd73a0"}