{"slug":"tanod-dev-v1-markets-local-premium-b3c2b9","title":"Use when an agent needs to gauge local demand for crypto","host":"tanod.dev","method":"POST","resource":"https://tanod.dev/v1/markets/local-premium","category":"market","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 glob","price_listed":0.002,"price_asked":0.002,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":306,"reported_calls_30d":2,"reported_payers_30d":2,"networks":["eip155:137","eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"description":"Optional filters; with none, every venue and the three assets.","properties":{"asset":{"anyOf":[{"maxLength":4,"minLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"BTC, ETH or USDT (default: all three)"},"country":{"anyOf":[{"maxLength":2,"minLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 alpha-2: KR, JP, ID, PH, TR, BR, MX or AR (default: all)"}},"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"asset":{"type":["string","null"]},"cache_seconds":{"type":"integer"},"country":{"type":["string","null"]},"credits":{"items":{"properties":{"api_docs":{"type":"string"},"name":{"type":"string"},"notice":{"type":"string"},"terms":{"type":"string"},"url":{"type":"string"},"venue":{"type":"string"}},"type":"object"},"type":"array"},"disclaimer":{"type":"string"},"errors":{"items":{"properties":{"code":{"type":"string"},"source":{"type":"string"}},"required":["source","code"],"type":"object"},"type":"array"},"max_quote_age_s":{"type":"integer"},"notes":{"items":{"type":"string"},"type":"array"},"quotes":{"items":{"properties":{"asset":{"type":"string"},"country":{"type":"string"},"credit":{"properties":{"name":{"type":"string"},"terms":{"type":"string"},"url":{"type":"string"}},"type":"object"},"currency":{"type":"string"},"fx_date":{"description":"date of the official rate (ECB: last working day)","type":"string"},"fx_rate":{"description":"local currency units per 1 USD","type":"number"},"fx_source":{"type":"string"},"live_usd_rate":{"description":"live local per USD quote from the same venue, where it has one","type":["number","null"]},"premium_pct":{"description":"(price_usd / global_usd - 1) x 100, using the official USD rate","type":["number","null"]},"premium_pct_live":{"type":["number","null"]},"price_basis":{"enum":["last","mid"],"type":"string"},"price_local":{"type":"number"},"price_usd":{"type":"number"},"quote_age_s":{"type":["integer","null"]},"quote_time":{"type":["string","null"]},"venue":{"type":"string"}},"required":["venue","country","currency","asset","price_local","price_usd","premium_pct","fx_rate","fx_source","fx_date","credit"],"type":"object"},"type":"array"},"reference":{"additionalProperties":{"properties":{"price_usd":{"type":"number"},"source":{"type":"string"},"stale":{"type":"boolean"},"updated_at":{"type":"string"}},"type":"object"},"description":"global USD price per asset","type":"object"},"retrieved_at":{"type":"string"},"stale_dropped":{"type":"integer"}},"required":["quotes","reference","errors","disclaimer"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-18","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.002,"price_match":true,"latency_ms":306,"error":null}],"description_full":"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.","last_updated":"2026-10-12T03:10:41.846Z","schemes":["exact"]}