Iran exchange rate API

Iran's market rates in toman, as an API

The dollar, euro, dirham, lira and 38 currencies in total against the toman, plus melted gold, the 18-carat gram and the coin series. Every price is a low/high range pooled from several market sources, over REST and a WebSocket that pushes each change.

  • 38 currencies
  • 7 gold and coins
  • WebSocket

38

currencies in toman

7

gold and coin prices

WebSocket

live push

What you get

  • A range, not one dealer's number

    Each price is the lowest and highest quote across several independent market sources, with how many sources back it, so you see the spread of the market, not one dealer's number.

  • Currencies and gold

    38 currencies against the toman, plus melted gold, the 18-carat gram and the coin series.

  • Pushed over WebSocket

    A snapshot when you connect, then only what moved: apply each frame as a patch.

  • In toman, labelled clearly

    Values are toman, not rial; gold is priced per its own unit (a gram for 18-carat, a full coin for coins).

  • ISO codes and Persian names

    Each currency carries its ISO code and its Persian name, ready for your interface.

  • Freshness you can check

    The feed says when its snapshot was taken; a stale one is marked degraded, never silently served as new.

Endpoints

Every request takes your key in the X-API-Key header (or Authorization: Bearer, or ?key=). Responses are JSON.

  • GET /rates

    Every currency and gold instrument, each as a low/high range in toman.

  • GET /rates/fx

    The 38 currencies only.

  • GET /rates/gold

    Gold and coins only.

  • WS /ws/rates

    A snapshot on connect, then partial change frames.

WebSocket:wss://api4.broker-radar.com/ws/rates

Each feed's full guide is open at /help on its own address, and its OpenAPI file downloads from your account page. Read the feed's guide

A first call · curl
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api4.broker-radar.com/rates/fx"
JSON
{
  "success": true,
  "total": 38,
  "fx": [
    {
      "symbol": "usd",
      "currency_iso": "USD",
      "name_fa": "دلار آمریکا",
      "buy":  { "low": 105200.0, "high": 105600.0 },
      "sell": { "low": 106100.0, "high": 106500.0 },
      "quotes": 3
    },
    { "symbol": "aed", "...": "..." }
  ],
  "timestamp": "2026-11-20T13:12:03.120Z"
}
WebSocket · JavaScript
const ws = new WebSocket("wss://api4.broker-radar.com/ws/rates?key=YOUR_API_KEY");
ws.onmessage = (event) => {
  const frame = JSON.parse(event.data);
  // a snapshot first, then frames with only what moved
};

Replace YOUR_API_KEY with a key from your account page.

Prices

Monthly or yearly, paid in USDT. Yearly is ten months' price for a full year. One key covers every feed you buy.

Monthly · Full feed

US$39 a month

Yearly · Full feed

US$390 a year

Built for

  • Exchange and fintech apps

    Show the market rate beside your own.

  • Shops and invoices

    Price in toman from a dollar or euro amount.

  • News and finance sites

    A live rates board without scraping.

  • Bots and channels

    Post the dollar and gold prices as they move.

One key, every feed you buy

There is no key per feed: one key works over REST and WebSocket on everything your account holds, and you can limit any key to some feeds, IP addresses or websites.

  • Forex spreads

    Bid, ask and spread at 176 retail forex brokers, live while the market is open: EUR/USD, GBP/USD, USD/JPY, gold, US30 and more. Ask for one broker, or every broker in a single call.

  • Prop firm spreads

    What traders actually pay at 37 prop firms: live spreads on their trading servers while the market is open, and typical spreads where a live feed isn't available. One firm, or every firm in one call.

  • Economic calendar

    Every release with its actual, forecast and previous value, pushed over WebSocket within about two seconds of publication. Economic, crypto, metals and energy calendars, with history and event details.

  • Crypto prices

    Bid, ask and last price for 25,256 markets at 42 crypto exchanges, refreshed about every 20 seconds. Ask for one coin across every exchange, cheapest ask first, or the whole board in one call.

Questions

A live feed of Iran's market rates in toman: 38 currencies and 7 gold and coin prices, over REST and WebSocket.

Each price is the lowest and highest quote across several independent market sources. A single dealer's number can be off; the range shows where the market is.

Toman. Gold is priced per its own unit: a gram for 18-carat gold, a full coin for the coins.

38 currencies, including the US dollar, euro, UAE dirham, Turkish lira and British pound, each with its ISO code and Persian name. GET /rates/fx lists them all.

Melted gold, the 18-carat gram and the coin series: 7 instruments at GET /rates/gold.

Connect to wss://api4.broker-radar.com/ws/rates with your key as ?key=. You get a snapshot, then frames with only what moved; apply them as patches.

The feed reports its snapshot's age; when the snapshot is older than three polls it says degraded, and still answers with the last good data.

No. These are free-market rates pooled from several market sources, which is what most Iranian apps and shops price against.

In USDT, monthly or yearly, on your account's API page; the prices are on this page.

Yes: rates in other local currencies are planned, each as its own product.
Contact

Data API

Iran's market rates in your app

Make a free account, buy the rates feed, and call it with your key.