# Tanod Local Crypto Premium Pricing

> Tanod Local Crypto Premium Pricing is a paid API for AI agents from tanod.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Fetches local-currency cryptocurrency prices from regional exchanges with USD conversion, FX rates, and premium/discount calculations versus global reference prices

## Facts

- Endpoint: POST https://tanod.dev/v1/markets/local-premium?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-local-crypto-premium-pricing-f3230fcc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5xAm4SXy5sCWopWHThndn

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tanod-local-crypto-premium-pricing-f3230fcc -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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 bel
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-local-crypto-premium-pricing-f3230fcc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)
