# Nerkh

> Nerkh (نرخ, Persian for "rate") publishes live Iranian Toman (IRT) exchange
> rates for 28 currencies, scraped from open-market sources and refreshed
> every 5 minutes, around the clock. Free JSON API, no key required.
> Also an iOS app with charts, widgets, a converter, and rate alerts.

Key facts:

- Rates are quoted in **Toman** (1 Toman = 10 Iranian Rial). These are
  open-market ("street") rates, not the official central-bank rate.
- Both **sell** and **buy** quotes are published per currency.
- Data updates every 5 minutes; JSON responses carry ISO-8601 UTC timestamps.
- Coverage: 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.
- Historical daily data accumulates from 2026-07-12 onward.

## API

Base URL: https://api.nerkh.org/api/v1 (same data also served at
https://d259v2xlznld3n.cloudfront.net/api/v1). No authentication, no API key,
CORS enabled (`Access-Control-Allow-Origin: *`). Cache: 30 s on live rates.

- [All live rates](https://api.nerkh.org/api/v1/rates/all.json): every
  currency — `{status, timestamp, currencies: [{code, name, buy_rate,
  sell_rate, last_updated}], total_currencies}`
- [Recent history](https://api.nerkh.org/api/v1/rates/recent.json): last 7
  days of daily closes — `{status, updated, days: [{date: "YYYY-MM-DD",
  rates: {CODE: {buy, sell}}}]}`
- [Full daily history](https://api.nerkh.org/api/v1/rates/history.json):
  all daily closes since 2026-07-12, same shape as recent.json
- Per-currency timeframes:
  `https://api.nerkh.org/api/v1/rates/history/{code}/{timeframe}.json` —
  `code` is **lowercase** (e.g. `usd`), `timeframe` is one of `1d`, `1w`,
  `1m`, `1y`, `all`. Returns `{status, code, updated, points: [{t, buy,
  sell}]}`. `1d`/`1w` are hourly averages; `1m`/`1y`/`all` are daily closes
  at 12:00 UTC. Example:
  [USD, last day](https://api.nerkh.org/api/v1/rates/history/usd/1d.json)

Full endpoint documentation: [API docs](https://nerkh.org/api.html)

## Use of the data

Rate data is free to use for personal, research, and journalistic purposes
with attribution to nerkh.org. It is informational only — verify with a
licensed exchange before transacting. No warranty of accuracy or
availability. For commercial/high-volume use, get in touch first.

## Contact

- Website: https://nerkh.org
- iOS app: coming soon to the App Store
- Email: alisaghi0931@gmail.com