Toman & Rial Rates

Live Iranian Rial (IRR) and Toman exchange rates — the conversion rate of 28 world currencies, gold, and Iranian gold coins — returned as clean JSON every time the Actor runs. No input required: run it and get the current rates.

نرخ لحظه‌ای ریال، تومان و تومن و همچنین نرخ طلا به‌صورت JSON. نرخ تبدیل دلار، یورو، پوند، درهم و ۲۴ ارز دیگر به تومان، به‌علاوهٔ سکه و طلای ۱۸ عیار.

It covers:

• 28 fiat currencies — USD, EUR, GBP, CHF, CAD, AUD, SEK, NOK, RUB, THB, SGD, HKD, AZN, AMD, DKK, AED, JPY, TRY, CNY, SAR, INR, MYR, AFN, KWD, IQD, BHD, OMR, QAR
• Gold — 18‑karat gram, mithqal, and the global ounce (in USD)
• Gold coins — Emami, Bahar Azadi (full / half / quarter), Gerami
• Bitcoin (in USD) and the Tehran Stock Exchange index

Rial and Toman

All rates in the output are in Toman. The Iranian Rial (IRR) is worth one‑tenth of a Toman, so to get a Rial value simply multiply by 10:

1 USD = 222,300 Toman = 2,223,000 Rial (IRR)

Output

Every run writes one JSON record to the default key‑value store under the key OUTPUT, and pushes the same object as a single dataset item:

{
  "updatedAt": "2026-09-03T07:19:04.000Z",
  "rates": {
    "USD": { "sell": 222300, "buy": 222200, "mid": 222250, "rate": 222300 },
    "EUR": { "sell": 257850, "buy": 257650, "mid": 257750, "rate": 257850 },
    "JPY": { "sell": 1410, "buy": 1400, "mid": 1405, "rate": 1410 },
    "COIN_EMAMI": { "sell": 234000000, "buy": 230000000, "mid": 232000000, "rate": 234000000 },
    "GOLD_GRAM_18K": { "rate": 23385197 },
    "GOLD_MITHQAL": { "rate": 100900000 },
    "GOLD_OUNCE": { "rate": 4423.29, "unit": "USD" },
    "BTC": { "rate": 77771.1, "unit": "USD" },
    "TSE_INDEX": { "rate": 1904324.2, "unit": "index" }
  }
}

Fields on each rate entry:

Field	Meaning
sell	Sell price, in Toman
buy	Buy price, in Toman
mid	Midpoint of sell and buy
rate	Headline rate — equal to sell
unit	Present only when the value is not in Toman (USD or index)

Notes:

• All fiat rates are quoted per 1 unit of the currency — e.g. JPY is the price of a single yen.
• Single‑value quotes (GOLD_GRAM_18K, GOLD_MITHQAL, GOLD_OUNCE, BTC, TSE_INDEX) expose rate only.

Input

Everything is optional.

Field	Type	Description
currencies	string[]	Which rates to return. Empty → all rates. Accepts individual codes and/or the group aliases FIAT, COINS, GOLD, CRYPTO, INDEX. Case‑insensitive.

Examples

Return everything:

{}

Only the US Dollar:

{ "currencies": ["USD"] }

Dollar, Euro and every gold coin:

{ "currencies": ["USD", "EUR", "COINS"] }

Reference — all codes

Group	Codes
Fiat	USD EUR GBP CHF CAD AUD SEK NOK RUB THB SGD HKD AZN AMD DKK AED JPY TRY CNY SAR INR MYR AFN KWD IQD BHD OMR QAR
Coins	COIN_EMAMI COIN_AZADI COIN_AZADI_HALF COIN_AZADI_QUARTER COIN_GERAMI
Gold	GOLD_GRAM_18K GOLD_MITHQAL GOLD_OUNCE
Other	BTC TSE_INDEX

---

Keywords: Iranian Rial, IRR, rial, toman, tomon, tooman, Toman rate, Rial rate, IRR exchange rate, USD to IRR, USD to Toman, EUR to Toman, dollar to rial, currency converter, Iran free market rate, gold price Iran, gold coin price, Bahar Azadi, Emami coin, ریال، تومان، تومن، نرخ ارز، نرخ دلار، نرخ یورو، نرخ طلا، نرخ سکه، قیمت طلا، قیمت دلار، نرخ تبدیل ارز، بازار آزاد ارز، دلار به تومان، یورو به تومان.