Nerkh API

Name: Nerkh — Iranian Toman Exchange Rates
Creator: Nerkh
License: https://nerkh.org/api.html#terms

Free JSON API for live Iranian Toman exchange rates — 28 currencies, refreshed every 5 minutes. No API key, no auth, CORS enabled. Built for humans, apps, and AI agents alike.

Basics

Base URL: https://api.nerkh.org/api/v1
Units: all rates are in Toman (1 Toman = 10 Iranian Rial). Open-market quotes, not the official rate.
Quotes: each currency has sell_rate (what you pay to buy the currency) and buy_rate.
Freshness: data is republished every 5 minutes; responses carry ISO-8601 UTC timestamps and Cache-Control: max-age=30. ETags are honored — send If-None-Match and you'll get 304.
Currencies: USD, EUR, GBP, CHF, CAD, AUD, SEK, NOK, RUB, THB, SGD, HKD, AZN, AMD, DKK, AED, JPY, TRY, CNY, SAR, INR, MYR, AFN, KWD, IQD, BHD, OMR, QAR.

Live rates — all currencies

GET /api/v1/rates/all.json

{
  "status": "success",
  "timestamp": "2026-07-16T23:20:21Z",
  "currencies": [
    {
      "code": "USD",
      "name": "US Dollar",
      "buy_rate": 187900.0,
      "sell_rate": 188000.0,
      "last_updated": "2026-07-16T23:20:21"
    }
  ],
  "total_currencies": 28
}

Recent history — last 7 days

GET /api/v1/rates/recent.json

{
  "status": "success",
  "updated": "2026-07-16T23:20:21Z",
  "days": [
    { "date": "2026-07-12",
      "rates": { "USD": { "buy": 178800.0, "sell": 178900.0 } } }
  ]
}

Full daily history

GET /api/v1/rates/history.json

Same shape as recent.json, one entry per UTC day, ascending, from 2026-07-12 onward (no older data exists).

Per-currency timeframes

GET /api/v1/rates/history/{code}/{timeframe}.json

code — currency code in lowercase, e.g. usd
timeframe — one of 1d, 1w, 1m, 1y, all
1d/1w points are hourly averages; 1m/1y/all are daily closes stamped 12:00 UTC

GET /api/v1/rates/history/usd/1d.json

{
  "status": "success",
  "code": "USD",
  "updated": "2026-07-16T23:20:21Z",
  "points": [
    { "t": "2026-07-16T22:00:00Z", "buy": 187900, "sell": 188000 }
  ]
}

Terms of use

Free for personal, research, and journalistic use with attribution to nerkh.org.
Informational only — verify with a licensed exchange before transacting. No warranty of accuracy or availability.
Be gentle: respect the 30-second cache (poll at most every 5 minutes — the data doesn't change faster). For commercial or high-volume use, email first.

For AI agents

A condensed, machine-readable overview of this site and API lives at nerkh.org/llms.txt. The live rates shown on the homepage are also server-rendered into the HTML, so non-JavaScript crawlers see current data.