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.
/v1/ratesLatest buy and sell rates — all or some symbols, in any unit (Toman, Rial, USD, USDT, EUR, gold gram…).
symbolsstringComma-separated: usd,eur,g18,emami,btc (empty = all)categorystringCategory: fiat, gold, coin, cryptomarketstringMarket: tehran (default), herat, sulaymaniyah, dubai, istanbul, havalequotestringPrice unit: IRT Toman (default), IRR Rial, or any asset symbol: usd, usdt, eur, g18, btc…langstringNames language: fa or enGET 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" }
}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)259400quote=irrRial2594000quote=usdin Tehran free-market USDEUR → 1.1204quote=usdtin USDTBTC → 84,896quote=g18in 18k gold gramsEmami → 10.02 gquote=eurin EURUSD → 0.893X-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
401Invalid or revoked key403Domain or IP not allowed404Unknown symbol429Daily/monthly quota exceededEZRate döviz API'si dolar, euro, dirhem, lira ve onlarca para biriminin İran tümeni ve riyaline karşı anlık alış-satış kurlarını JSON olarak verir — siteniz, uygulamanız, Telegram botunuz veya tablonuz için. Kurlar, işlem gruplarındaki ve döviz bürolarındaki gerçek işlemlerin medyanıdır, 60 saniyede bir güncellenir; ücretsiz plan kart gerektirmez.
Aynı anahtarla 18 ve 24 ayar gram altın, miskal, İmami ve Bahar Azadi sikkeleri, ons altın ile bitcoin, ether ve USDT fiyatlarını dolar ve tümen olarak alırsınız. Çıktı birimi seçilebilir: tümen, riyal, dolar veya USDT.
Fiyatların yanında API kripto cüzdan risk kontrolü de sunar: GET /v1/wallet/check risk skoru, USDT dondurma durumu, yaptırımlar, adres sahibi ve karşı tarafları döndürür. Ayrıntılar cüzdan kontrol sayfasında.