{"uid":"cap_5xAm4SXy5sCWopWHThndn","slug":"tanod-local-crypto-premium-pricing-f3230fcc","name":"Tanod Local Crypto Premium Pricing","description":"Use when an agent needs to gauge local demand for crypto: the kimchi or USDT premium on local exchanges vs the global price. Kimchi premium API: BTC, ETH and USDT on local exchanges (Korea, Japan, Indonesia, Philippines, Turkey, Brazil, Mexico, Argentina) in USD, as a premium or discount to the global price, with FX source and date. Includes the USDT premium in Turkey and Argentina.","url":"https://tanod.dev/v1/markets/local-premium?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"asset":{"anyOf":[{"type":"string","maxLength":4,"minLength":3},{"type":"null"}],"default":null,"description":"BTC, ETH or USDT (default: all three)"},"country":{"anyOf":[{"type":"string","maxLength":2,"minLength":2},{"type":"null"}],"default":null,"description":"ISO 3166-1 alpha-2: KR, JP, ID, PH, TR, BR, MX or AR (default: all)"}}},"responseSchema":{"type":"json","example":{"asset":null,"notes":["BTC and ETH global price: Chainlink on-chain USD feeds on Ethereum (updated on 0.5 % moves or hourly), via /v1/chain/price. USDT is referenced to 1.0.","ECB reference rates are a once-a-day fixing published on working days (fx_date shows the day used); BCRA's rate is the official wholesale rate. Live dollar quotes, where present, are in live_usd_rate."],"errors":[],"quotes":[{"asset":"BTC","venue":"btcturk","credit":{"url":"https://www.btcturk.com","name":"BtcTurk","terms":"unclear"},"country":"TR","fx_date":"2026-10-09","fx_rate":49.173032,"currency":"TRY","fx_source":"ECB euro reference rates, crossed to USD","price_usd":83103.316,"quote_time":"2026-10-11T00:43:43Z","premium_pct":0.245,"price_basis":"last","price_local":4086442,"quote_age_s":2,"live_usd_rate":49.252,"premium_pct_live":0.085},{"asset":"USDT","venue":"btcturk","credit":{"url":"https://www.btcturk.com","name":"BtcTurk","terms":"unclear"},"country":"TR","fx_date":"2026-10-09","fx_rate":49.173032,"currency":"TRY","fx_source":"ECB euro reference rates, crossed to USD","price_usd":1.0016059,"quote_time":"2026-10-11T00:43:43Z","premium_pct":0.161,"price_basis":"last","price_local":49.252,"quote_age_s":2,"live_usd_rate":null,"premium_pct_live":null}],"country":"TR","credits":[{"url":"https://www.btcturk.com","name":"BtcTurk","terms":"unclear","venue":"btcturk","notice":"Prices from BtcTurk's public ticker API. No API terms forbidding redistribution of public prices were found, but the venue's own terms could not be fully reviewed (terms unclear).","api_docs":"https://docs.btcturk.com"}],"reference":{"BTC":{"stale":false,"source":"Chainlink BTC/USD on Ethereum (chain.price)","price_usd":82899.84679684,"updated_at":"2026-10-11T00:34:47Z","age_seconds":529},"USDT":{"source":"fixed at 1.0 (USDT is referenced to USD)","price_usd":1}},"disclaimer":"Informational only, not a trading quote or investment advice. Exchange prices are last trades or midpoints from public tickers; premiums depend on the reference and FX rate used and are noisy below about 0.5 %.","retrieved_at":"2026-10-11T00:43:45Z","cache_seconds":30,"stale_dropped":0,"max_quote_age_s":600}},"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_6EmVfjKoScLHCKf0CAaH_","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":"Fetches local-currency cryptocurrency prices from regional exchanges with USD conversion, FX rates, and premium/discount calculations versus global reference prices","exampleAgentPrompt":"What's the current BTC price on Turkish exchanges in local currency, and how much of a premium is it trading at versus the global Chainlink price?","exampleUseCases":[{"title":"Kimchi premium tracker for Korean market","prompt":"Check the current BTC and ETH prices on Korean exchanges and tell me what premium they're trading at compared to the global reference price."},{"title":"Argentina USDT street premium monitor","prompt":"What's the USDT price on Argentine exchanges right now, and how does it compare to the global dollar price — is there a big premium?"},{"title":"Multi-country crypto price comparison","prompt":"Get me BTC prices across all supported countries — Brazil, Mexico, Turkey, and the Philippines — so I can see where the biggest local premiums or discounts are right now."}],"resultDescription":"Returns an array of quotes per asset and venue, each including local currency price, USD equivalent, FX rate used (with source and date), live USD rate where available, premium percentage vs global reference (both FX-date-based and live), quote timestamp and age in seconds, venue credit info, and global reference prices from Chainlink. Also includes notes, errors, and a disclaimer.","failureModes":["Unsupported country code returns empty quotes array","Unsupported asset symbol returns empty quotes or error","Exchange API temporarily unavailable results in missing venue data","FX rates may be stale (ECB rates are once-daily; BCRA rates are official wholesale only)","Chainlink reference price may be up to 1 hour old if no 0.5% move occurred"],"whenToPreferThis":"Use this endpoint when you need cryptocurrency prices denominated in local currencies for specific emerging or regional markets (TR, KR, JP, ID, PH, BR, MX, AR), along with premium/discount calculations against global reference prices. Prefer this over generic crypto price APIs when regional exchange premiums, local FX dynamics, or cross-border arbitrage signals are relevant.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T06:51:41.931Z","isFirstParty":false,"canonicalSlug":"tanod-local-crypto-premium-pricing-f3230fcc"}