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 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 /ratesEvery currency and gold instrument, each as a low/high range in toman.
GET /rates/fxThe 38 currencies only.
GET /rates/goldGold and coins only.
WS /ws/ratesA 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
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api4.broker-radar.com/rates/fx"{
"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"
}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.
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.
Other data feeds
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.