EZRateDevelopers
FAEN
Get a free key
api.ezrate.me/v1

Real-market API for Iran’s FX, gold and crypto rates

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

A free exchange rate API with real free-market rates

The EZRate exchange rate API returns live buy and sell rates for the US dollar, euro, dirham, lira and dozens of other currencies against the Iranian toman and rial as JSON — for your website, app, Telegram bot or spreadsheet. Rates are the median of real trading groups and exchanges, refreshed every 60 seconds. The free plan needs no card.

Gold, coin and crypto prices from the same API

18K and 24K gold per gram, mesghal, Emami and Bahar Azadi coins and the global ounce come with the same key, with coin bubble and 24-hour change. Bitcoin, Ethereum, USDT and other crypto are priced in both USD and toman using the real USDT rate.

Free currency widgets and charts for your website

Not a developer? Build a live rate table or chart in your dashboard and paste one line of code into your site, or install the WordPress plugin.

Frequently asked questions

Yes. The free plan includes 1,500 requests per month and needs no card. Paid plans with higher limits are paid in USDT (TRC20 or BEP20).

Rates are recalculated from trading sources every 60 seconds, and every response carries the time of the last update.

Yes — gold, coins, the global ounce, USDT and other crypto come with the same key, in toman, rial, USD or USDT.