Markets Local Premium

{
  "asset": null,
  "cache_seconds": 30,
  "country": "TR",
  "credits": [
    {
      "api_docs": "https://docs.btcturk.com",
      "name": "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).",
      "terms": "unclear",
      "url": "https://www.btcturk.com",
      "venue": "btcturk"
    }
  ],
  "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 %.",
  "errors": [],
  "max_quote_age_s": 600,
  "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."
  ],
  "quotes": [
    {
      "asset": "BTC",
      "country": "TR",
      "credit": {
        "name": "BtcTurk",
        "terms": "unclear",
        "url": "https://www.btcturk.com"
      },
      "currency": "TRY",
      "fx_date": "2026-10-09",
      "fx_rate": 49.173032,
      "fx_source": "ECB euro reference rates, crossed to USD",
      "live_usd_rate": 49.252,
      "premium_pct": 0.245,
      "premium_pct_live": 0.085,
      "price_basis": "last",
      "price_local": 4086442,
      "price_usd": 83103.316,
      "quote_age_s": 2,
      "quote_time": "2026-10-11T00:43:43Z",
      "venue": "btcturk"
    },
    {
      "asset": "USDT",
      "country": "TR",
      "credit": {
        "name": "BtcTurk",
        "terms": "unclear",
        "url": "https://www.btcturk.com"
      },
      "currency": "TRY",
      "fx_date": "2026-10-09",
      "fx_rate": 49.173032,
      "fx_source": "ECB euro reference rates, crossed to USD",
      "live_usd_rate": null,
      "premium_pct": 0.161,
      "premium_pct_live": null,
      "price_basis": "last",
      "price_local": 49.252,
      "price_usd": 1.0016059,
      "quote_age_s": 2,
      "quote_time": "2026-10-11T00:43:43Z",
      "venue": "btcturk"
    }
  ],
  "reference": {
    "BTC": {
      "age_seconds": 529,
      "price_usd": 82899.84679684,
      "source": "Chainlink BTC/USD on Ethereum (chain.price)",
      "stale": false,
      "updated_at": "2026-10-11T00:34:47Z"
    },
    "USDT": {
      "price_usd": 1,
      "source": "fixed at 1.0 (USDT is referenced to USD)"
    }
  },
  "retrieved_at": "2026-10-11T00:43:45Z",
  "stale_dropped": 0
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://tanod.dev/v1/markets/local-premium' \
  -H 'content-type: application/json' \
  --data-raw '{}'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://tanod.dev/v1/markets/local-premium' \
  -H 'content-type: application/json' \
  --data-raw '{}' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.002 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.002" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.002 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Ftanod.dev%2Fv1%2Fmarkets%2Flocal-premium&method=POST
const res = await pay("https://tanod.dev/v1/markets/local-premium", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({}),
});
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.002 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.002"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.post(
        "https://tanod.dev/v1/markets/local-premium",
        json={},
    )
    print(res.status_code, res.text)