{"uid":"cap_sjPPgAVL4sAE3MX1nqJ5Z","slug":"kimchi-premium-oracle-x402-19ed1dac","name":"Kimchi Premium Oracle (x402)","description":"Dual-basis KRW market intel for agents: kimchi premium on official-FX and USDT-KRW tradeable basis, two Korean exchanges, plain HTTPS JSON. Pay-per-call USDC on Base via x402 v2.","url":"https://kimchi-x402.pn-26f.workers.dev/v1/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"symbols":{"type":"string","description":"Comma-separated symbols, max 20 (default BTC,ETH,XRP,SOL,DOGE)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"basis":{"upbitUsdtKrw":1351,"officialUsdkrw":1358.97,"usdtKrwPremiumPct":-0.586},"symbols":[{"symbol":"BTC","upbitKrw":114078000,"globalUsd":84336.1,"upbitPremiumOfficialPct":-0.496,"upbitPremiumUsdtBasisPct":0.091}]}}},"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_kd0dn17TDs51oPzRcn4XI","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 real-time kimchi premium percentages for Korean crypto markets on both official USD/KRW FX basis and USDT/KRW tradeable basis, across two Korean exchanges.","exampleAgentPrompt":"What's the current kimchi premium for BTC and ETH — give me both the official FX basis and the USDT-tradeable basis from Upbit?","exampleUseCases":[{"title":"Crypto arbitrage opportunity scanner","prompt":"Check the kimchi premium for BTC, ETH, XRP, and SOL right now — I want to know both the official FX basis and the USDT basis so I can spot any arbitrage between Korean and global markets."},{"title":"Korean market price dashboard","prompt":"Pull the current Upbit KRW prices and kimchi premiums for BTC and DOGE, and tell me what the official USD/KRW and USDT/KRW rates are today."},{"title":"USDT-KRW spread monitoring alert","prompt":"What's the USDT/KRW premium percentage right now, and how does it compare to the official FX rate? I'm watching whether the USDT basis is diverging from the official rate."}],"resultDescription":"A JSON object containing: the basis block with official USD/KRW FX rate, USDT/KRW rate on Upbit, and the USDT/KRW premium percentage; plus a symbols array where each entry has the coin symbol, its KRW price on Upbit, its global USD price, the kimchi premium on official FX basis (%), and the kimchi premium on USDT tradeable basis (%).","failureModes":["Payment not received or invalid x402 USDC payment header — returns 402 Payment Required","Symbol not found or unsupported on Korean exchanges — that symbol may be omitted or return null values","Too many symbols requested (over 20) — returns validation error","Exchange API downstream outage — may return stale or partial data","Malformed symbols query parameter — returns 400 Bad Request"],"whenToPreferThis":"Choose this endpoint when you need dual-basis kimchi premium data (both official FX and USDT-tradeable) in a single call, paid per-use with no subscription. Ideal for agents doing arbitrage analysis, Korean market monitoring, or FX-adjusted crypto pricing — especially when you want the USDT/KRW spread alongside per-coin premiums. Prefer over generic crypto price APIs when Korean exchange pricing and kimchi premium specifically are the target.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T18:31:16.410Z","isFirstParty":false,"canonicalSlug":"kimchi-premium-oracle-x402-19ed1dac"}