EZRateDevelopers
Получить бесплатный ключ
api.ezrate.me/v1

API курсов валют, золота и криптовалют Ирана

The same data you see on EZRate — the median of live trading groups, plus history and charts — in one simple REST call. JSON output, bilingual names, ready for mobile apps.

curl "https://api.ezrate.me/v1/rates?symbols=usd,eur,emami,usdt&quote=irt&lang=fa" \
  -H "X-API-Key: ezr_live_xxxx"

Pricing

Paid in USDT (TRC20 / BEP20). 3 months −5% · yearly = 10 months.
Free
Websites and side projects
Free
✓1,500 requests / month
✓50 requests / day
✓Data freshness: 30 min
✓All currencies, gold and crypto
✓Widget and WordPress plugin
Start free
BasicPopular
Shops and small exchanges
9 USDT / month
✓30,000 requests / month
✓Data freshness: 5 min
✓1-year history
✓No widget watermark
✓Webhook alerts
Buy plan
Pro
Apps and fintechs
29 USDT / month
✓150,000 requests / month
✓Data freshness: 1 min
✓Full history and OHLC
✓Per-source rates
✓Priority support
Buy plan
Enterprise
Banks, media, high volume
Custom
✓Unlimited requests
✓Live WebSocket
✓SLA and dedicated IP
✓Contract and invoice
✓Pay with USDT TRC20 / BEP20
Contact sales
GET/v1/rates

Live rates

Latest buy and sell rates — all or some symbols, in any unit (Toman, Rial, USD, USDT, EUR, gold gram…).

ParameterTypeDescription
symbolsstringComma-separated: usd,eur,g18,emami,btc (empty = all)
categorystringCategory: fiat, gold, coin, crypto
marketstringMarket: tehran (default), herat, sulaymaniyah, dubai, istanbul, havale
quotestringPrice unit: IRT Toman (default), IRR Rial, or any asset symbol: usd, usdt, eur, g18, btc…
langstringNames language: fa or en
GET https://api.ezrate.me/v1/rates?symbols=usd,btc
X-API-Key: ezr_live_xxxx

{
  "data": [
    { "symbol": "usd", "code": "USD", "name": "US Dollar", "category": "fiat",
      "market": "tehran", "quote": "IRT", "buy": 259200, "sell": 259400,
      "usd": null, "change_pct": 1.14, "sources": 14, "low_sources": false,
      "updated_at": "2026-10-01T10:15:00Z" },
    { "symbol": "btc", "code": "BTC", "name": "Bitcoin", "category": "crypto",
      "market": "global", "quote": "IRT", "buy": 21820000000, "sell": 21859000000,
      "usd": "84896.00000000", "change_pct": 1.43, "sources": 1, "low_sources": true,
      "updated_at": "2026-10-01T10:15:00Z" }
  ],
  "meta": { "as_of": "2026-10-01T10:15:00Z", "freshness_sec": 1800, "quote": "IRT" }
}

Price unit: the quote parameter

Every rate in any unit: Toman, Rial, or any asset in terms of another (USD, USDT, EUR, gold grams…). Price in X = Toman price ÷ Toman price of X (buy with buy, sell with sell). The same units work in /convert and /cross. Auth: X-API-Key header or Authorization: Bearer.

quote=irtToman (default)259400
quote=irrRial2594000
quote=usdin Tehran free-market USDEUR → 1.1204
quote=usdtin USDTBTC → 84,896
quote=g18in 18k gold gramsEmami → 10.02 g
quote=eurin EURUSD → 0.893
Rate limits
X-RateLimit-Limit-Day: 50
X-RateLimit-Remaining-Day: 12
X-RateLimit-Limit-Month: 1500
X-RateLimit-Remaining-Month: 858
X-RateLimit-Reset: 2026-10-01T00:00:00Z
Error codes
401Invalid or revoked key403Domain or IP not allowed404Unknown symbol429Daily/monthly quota exceeded

API курса иранского риала и тумана

API курсов EZRate отдаёт текущие курсы покупки и продажи доллара, евро, дирхама, лиры и десятков валют к иранскому туману и риалу в формате JSON — для сайта, приложения, Telegram-бота или таблицы. Курсы — медиана реальных сделок в торговых группах и у обменников, обновление каждые 60 секунд, бесплатный тариф без карты.

Золото, монеты и криптовалюты

Тем же ключом доступны цена грамма золота 18 и 24 карата, мескаль, монеты Эмами и Бахар Азади, мировая унция, а также биткоин, эфир и USDT в долларах и туманах. Единица ответа на выбор: туман, риал, доллар или USDT.

AML-проверка кошельков через API

Кроме курсов, API проверяет криптокошельки на риски: GET /v1/wallet/check возвращает оценку риска, заморозку USDT, санкции, владельца адреса и контрагентов. Подробнее — на странице проверки кошелька.

Frequently asked questions

Да: бесплатный тариф — 1 500 запросов в месяц без карты; платные тарифы оплачиваются в USDT.

Каждые 60 секунд; в каждом ответе указано время последнего обновления.

Да, тем же ключом и в любой единице: туман, риал, доллар или USDT.