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

Exchange rate 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. As a free exchange rate API it needs no card: sign up and create a key. Rates are the median of real trading groups and exchanges, never copied from other sites, and refreshed every 60 seconds.

Iranian rial and toman exchange rate API

Our Iranian rial exchange rate API and toman exchange rate API cover the free market of Tehran and other markets, with the number of live sources and the update time in every response. See the same numbers on the US dollar price and USDT price pages — the USDT to toman API uses real USDT trades, not an estimate.

Gold price API for Iran

The gold price API Iran developers use returns 18K and 24K gold per gram, mesghal, Emami and Bahar Azadi coins and the global ounce with the same key, including coin bubble, intrinsic value and 24-hour change — see the live 18K gold price.

Crypto price API in USD and toman

Our crypto price API gives Bitcoin, Ethereum, USDT and other coins in both USD and toman. Choose the unit of any response with the quote parameter: toman, rial, USD, USDT, euro or even grams of gold.

How it works

  1. Sign up and create a free key in your dashboard (API section).
  2. Send the key in the X-API-Key header and call the rates endpoint; the JSON has buy, sell, change and update time.
  3. Show the result on your site or app and read it again every few minutes — rates refresh every 60 seconds.

Currency widget for website and free chart

Not a developer? Build a currency widget for website use — a table, ticker or free currency chart widget in any language and currency — and paste one line of code, or install the WordPress plugin. See website price widgets.

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.

From the median of real trades in currency, gold and coin trading groups; outliers are removed and no other site is copied. The methodology page explains the method.