{"openapi":"3.1.0","info":{"title":"Iran Rial Market API","version":"1.0.0","description":"Live free-market (bazaar) prices for the Iranian rial against foreign currencies, gold and gold coins. Iran's official rate is fixed and unused in practice; the real economy trades on the open bazaar rate, which is what this API exposes. The price endpoint returns one instrument's latest close/open/high/low, day change and date — in both rial and toman. The currencies endpoint returns every foreign currency (USD, EUR, GBP, AED, TRY, CNY, RUB …) against the rial at once. The gold endpoint returns Iran's gold market — the global ounce, 18k and 24k gram, the mesghal, and the famous gold coins (Emami, Bahar Azadi, half, quarter, gerami). The history endpoint returns an instrument's daily OHLC series. Read live, nothing stored. This is Iran's own free-market rial/gold/coin layer — distinct from official central-bank feeds and from other countries' parallel-dollar APIs.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/irr-api","description":"oanor gateway"}],"tags":[{"name":"Price"},{"name":"Currencies"},{"name":"Gold"},{"name":"History"},{"name":"Symbols"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/price":{"get":{"operationId":"get_v1_price","tags":["Price"],"summary":"One instrument's latest price by symbol","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Instrument symbol (usd, eur, ounce, coin_emami …)","schema":{"type":"string"},"example":"usd"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"low":1757800,"date":"2026/06/10","high":1785200,"name":"US Dollar","open":1785100,"unit":"IRR","close":1758050,"change":32100,"source":"tgju.org","symbol":"usd","category":"currency","change_pct":1.83,"close_toman":175805,"date_jalali":"1405/03/20"},"meta":{"timestamp":"2026-06-10T22:57:35.748Z","request_id":"375895f3-0cb1-4ac7-af2b-eb0467b8b6b5"},"status":"ok","message":"Price retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/currencies":{"get":{"operationId":"get_v1_currencies","tags":["Currencies"],"summary":"Every foreign currency vs the rial","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"IRR","count":11,"source":"tgju.org","currencies":[{"low":2354800,"date":"2026/06/10","high":2397200,"name":"British Pound","open":2392100,"unit":"IRR","close":2355100,"change":45700,"symbol":"gbp","category":"currency","change_pct":1.95,"close_toman":235510,"date_jalali":"1405/03/20"},{"low":2201100,"date":"2026/06/10","high":2240800,"name":"Swiss Franc","open":2236400,"unit":"IRR","close":2202400,"change":40000,"symbol":"chf","category":"currency","change_pct":1.82,"close_toman":220240,"date_jalali":"1405/03/20"},{"low":2031000,"date":"2026/06/10","high":2065800,"name":"Euro","open":2063100,"unit":"IRR","close":2031300,"change":39000,"symbol":"eur","category":"currency","change_pct":1.93,"close_toman":203130,"date_jalali":"1405/03/20"},{"low":1757800,"date":"2026/06/10","high":1785200,"name":"US Dollar","open":1785100,"unit":"IRR","close":1758050,"change":32100,"symbol":"usd","category":"currency","change_pct":1.83,"close_toman":175805,"date_jalali":"1405/03/20"},{"low":1261600,"date":"2026/06/10","high":1284400,"name":"Canadian Dollar","open":1282000,"unit":"IRR","close":1261900,"change":25900,"symbol":"cad","category":"currency","change_pct":2.06,"close_toman":126190,"date_jalali":"1405/03/20"},{"low":1233300,"date":"2026/06/10","high":1255900,"name":"Australian Dollar","open":1253800,"unit":"IRR","close":1233800,"change":22700,"symbol":"aud","category":"currency","change_pct":1.84,"close_toman":123380,"date_jalali":"1405/03/20"},{"low":1095990,"date":"2026/06/10","high":1113430,"name":"Japanese Yen (100)","open":1112290,"unit":"IRR","close":1096350,"change":18820,"symbol":"jpy","category":"currency","change_pct":1.72,"close_toman":109635,"date_jalali":"1405/03/20"},{"low":478770,"date":"2026/06/10","high":486230,"name":"UAE Dirham","open":486120,"unit":"IRR","close":478850,"change":8600,"symbol":"aed","category":"currency","change_pct":1.8,"close_toman":47885,"date_jalali":"1405/03/20"},{"low":259400,"date":"2026/06/10","high":263500,"name":"Chinese Yuan","open":263500,"unit":"IRR","close":259500,"change":4600,"symbol":"cny","category":"currency","change_pct":1.78,"close_toman":25950,"date_jalali":"1405/03/20"},{"low":38100,"date":"2026/06/10","high":38700,"name":"Turkish Lira","open":38700,"unit":"IRR","close":38200,"change":700,"symbol":"try","category":"currency","change_pct":1.84,"close_toman":3820,"date_jalali":"1405/03/20"},{"low":24470,"date":"2026/06/10","high":25050,"name":"Russian Ruble","open":24750,"unit":"IRR","close":24540,"change":350,"symbol":"rub","category":"currency","change_pct":1.43,"close_toman":2454,"date_jalali":"1405/03/20"}]},"meta":{"timestamp":"2026-06-10T22:57:43.291Z","request_id":"ffe075e7-de7d-4503-a14e-17703aea3b11"},"status":"ok","message":"Currencies retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/gold":{"get":{"operationId":"get_v1_gold","tags":["Gold"],"summary":"Iran gold market — ounce, gram, coins","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"gold":[{"low":4071.25,"date":"2026/06/10","high":4262.23,"name":"Gold Ounce (global)","open":4078.86,"unit":"USD","close":4260.4,"change":-180.73,"symbol":"ounce","category":"gold","change_pct":-4.43,"date_jalali":"1405/03/20"},{"low":177513000,"date":"2026/06/10","high":179249000,"name":"Gold 18k (gram)","open":179143000,"unit":"IRR","close":179249000,"change":-108000,"symbol":"gram_18k","category":"gold","change_pct":-0.06,"close_toman":17924900,"date_jalali":"1405/03/20"},{"low":236681000,"date":"2026/06/10","high":238996000,"name":"Gold 24k (gram)","open":238854000,"unit":"IRR","close":238996000,"change":-145000,"symbol":"gram_24k","category":"gold","change_pct":-0.06,"close_toman":23899600,"date_jalali":"1405/03/20"},{"low":768950000,"date":"2026/06/10","high":776350000,"name":"Gold Mesghal","open":776350000,"unit":"IRR","close":771450000,"change":-120000,"symbol":"mesghal","category":"gold","change_pct":-0.02,"close_toman":77145000,"date_jalali":"1405/03/20"},{"low":1789800000,"date":"2026/06/10","high":1810100000,"name":"Emami Gold Coin","open":1810100000,"unit":"IRR","close":1794800000,"change":250000,"symbol":"coin_emami","category":"coin","change_pct":0.01,"close_toman":179480000,"date_jalali":"1405/03/20"},{"low":1749700000,"date":"2026/06/10","high":1760200000,"name":"Bahar Azadi Gold Coin","open":1760050000,"unit":"IRR","close":1750200000,"change":50000,"symbol":"coin_bahar","category":"coin","close_toman":175020000,"date_jalali":"1405/03/20"},{"low":920000000,"date":"2026/06/10","high":920000000,"name":"Half Gold Coin","open":920000000,"unit":"IRR","close":920000000,"change":-5000000,"symbol":"half_coin","category":"coin","change_pct":-0.54,"close_toman":92000000,"date_jalali":"1405/03/20"},{"low":515000000,"date":"2026/06/10","high":520000000,"name":"Quarter Gold Coin","open":520000000,"unit":"IRR","close":515000000,"symbol":"quarter_coin","category":"coin","close_toman":51500000,"date_jalali":"1405/03/20"},{"low":270000000,"date":"2026/06/10","high":270000000,"name":"Gerami Gold Coin","open":270000000,"unit":"IRR","close":270000000,"change":-10000000,"symbol":"gerami_coin","category":"coin","change_pct":-3.7,"close_toman":27000000,"date_jalali":"1405/03/20"}],"note":"Iran gold market — global ounce (USD), 18k/24k gram and gold coins (Emami, Bahar Azadi, half, quarter, gerami), in rial.","count":9,"source":"tgju.org"},"meta":{"timestamp":"2026-06-10T22:57:49.688Z","request_id":"d8f721e0-ea60-4303-8192-51b571fa58a9"},"status":"ok","message":"Gold retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/history":{"get":{"operationId":"get_v1_history","tags":["History"],"summary":"Daily OHLC series for an instrument","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Instrument symbol","schema":{"type":"string"},"example":"usd"},{"name":"limit","in":"query","required":false,"description":"Rows (1-365)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"US Dollar","unit":"IRR","count":30,"source":"tgju.org","symbol":"usd","history":[{"low":1757800,"date":"2026/06/10","high":1785200,"open":1785100,"close":1758050,"date_jalali":"1405/03/20"},{"low":1751800,"date":"2026/06/09","high":1770200,"open":1753000,"close":1769800,"date_jalali":"1405/03/19"},{"low":1772800,"date":"2026/06/08","high":1788200,"open":1774000,"close":1782150,"date_jalali":"1405/03/18"},{"low":1747800,"date":"2026/06/07","high":1780200,"open":1780100,"close":1747950,"date_jalali":"1405/03/17"},{"low":1734800,"date":"2026/06/06","high":1755200,"open":1749900,"close":1735000,"date_jalali":"1405/03/16"},{"low":1737800,"date":"2026/06/03","high":1748200,"open":1744200,"close":1745100,"date_jalali":"1405/03/13"},{"low":1739800,"date":"2026/06/02","high":1755200,"open":1745200,"close":1744950,"date_jalali":"1405/03/12"},{"low":1714800,"date":"2026/06/01","high":1770200,"open":1761800,"close":1715150,"date_jalali":"1405/03/11"},{"low":1699800,"date":"2026/05/31","high":1710200,"open":1704850,"close":1709900,"date_jalali":"1405/03/10"},{"low":1699800,"date":"2026/05/30","high":1740200,"open":1704900,"close":1739800,"date_jalali":"1405/03/09"},{"low":1723800,"date":"2026/05/28","high":1745200,"open":1745000,"close":1723950,"date_jalali":"1405/03/07"},{"low":1718800,"date":"2026/05/26","high":1734200,"open":1724000,"close":1733850,"date_jalali":"1405/03/05"},{"low":1723800,"date":"2026/05/25","high":1754200,"open":1739100,"close":1723950,"date_jalali":"1405/03/04"},{"low":1683800,"date":"2026/05/24","high":1767200,"open":1699100,"close":1767200,"date_jalali":"1405/03/03"},{"low":1773850,"date":"2026/05/23","high":1794200,"open":1774200,"close":1792100,"date_jalali":"1405/03/02"},{"low":1786800,"date":"2026/05/21","high":1799200,"open":1790800,"close":1799150,"date_jalali":"1405/02/31"},{"low":1783800,"date":"2026/05/20","high":1824200,"open":1799100,"close":1784100,"date_jalali":"1405/02/30"},{"low":1771850,"date":"2026/05/19","high":1794200,"open":1784000,"close":1794200,"date_jalali":"1405/02/29"},{"low":1788800,"date":"2026/05/18","high":1809200,"open":1799200,"close":1809200,"date_jalali":"1405/02/28"},{"low":1798800,"date":"2026/05/17","high":1829200,"open":1813900,"close":1799050,"date_jalali":"1405/02/27"},{"low":1793800,"date":"2026/05/16","high":1814200,"open":1794000,"close":1803900,"date_jalali":"1405/02/26"},{"low":1788800,"date":"2026/05/14","high":1804200,"open":1798900,"close":1794150,"date_jalali":"1405/02/24"},{"low":1778800,"date":"2026/05/13","high":1804200,"open":1788950,"close":1804100,"date_jalali":"1405/02/23"},{"low":1798800,"date":"2026/05/12","high":1824200,"open":1804000,"close":1813900,"date_jalali":"1405/02/22"},{"low":1799800,"date":"2026/05/11","high":1824200,"open":1819050,"close":1804200,"date_jalali":"1405/02/21"},{"low":1758800,"date":"2026/05/10","high":1779200,"open":1758800,"close":1778800,"date_jalali":"1405/02/20"},{"low":1778800,"date":"2026/05/09","high":1784200,"open":1778900,"close":1779000,"date_jalali":"1405/02/19"},{"low":1738800,"date":"2026/05/07","high":1754200,"open":1754200,"close":1743850,"date_jalali":"1405/02/17"},{"low":1743800,"date":"2026/05/06","high":1794200,"open":1763800,"close":1789200,"date_jalali":"1405/02/16"},{"low":1798800,"date":"2026/05/05","high":1829200,"open":1813800,"close":1818900,"date_jalali":"1405/02/15"}]},"meta":{"timestamp":"2026-06-10T22:57:52.771Z","request_id":"ab3863f6-4ff8-4831-829c-6e5597c00604"},"status":"ok","message":"History retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/symbols":{"get":{"operationId":"get_v1_symbols","tags":["Symbols"],"summary":"All supported symbols","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":21,"source":"tgju.org","symbols":[{"name":"US Dollar","unit":"IRR","symbol":"usd","category":"currency"},{"name":"Euro","unit":"IRR","symbol":"eur","category":"currency"},{"name":"British Pound","unit":"IRR","symbol":"gbp","category":"currency"},{"name":"UAE Dirham","unit":"IRR","symbol":"aed","category":"currency"},{"name":"Turkish Lira","unit":"IRR","symbol":"try","category":"currency"},{"name":"Canadian Dollar","unit":"IRR","symbol":"cad","category":"currency"},{"name":"Australian Dollar","unit":"IRR","symbol":"aud","category":"currency"},{"name":"Swiss Franc","unit":"IRR","symbol":"chf","category":"currency"},{"name":"Chinese Yuan","unit":"IRR","symbol":"cny","category":"currency"},{"name":"Japanese Yen (100)","unit":"IRR","symbol":"jpy","category":"currency"},{"name":"Russian Ruble","unit":"IRR","symbol":"rub","category":"currency"},{"name":"Gold Ounce (global)","unit":"USD","symbol":"ounce","category":"gold"},{"name":"Gold 18k (gram)","unit":"IRR","symbol":"gram_18k","category":"gold"},{"name":"Gold 24k (gram)","unit":"IRR","symbol":"gram_24k","category":"gold"},{"name":"Gold Mesghal","unit":"IRR","symbol":"mesghal","category":"gold"},{"name":"Emami Gold Coin","unit":"IRR","symbol":"coin_emami","category":"coin"},{"name":"Bahar Azadi Gold Coin","unit":"IRR","symbol":"coin_bahar","category":"coin"},{"name":"Half Gold Coin","unit":"IRR","symbol":"half_coin","category":"coin"},{"name":"Quarter Gold Coin","unit":"IRR","symbol":"quarter_coin","category":"coin"},{"name":"Gerami Gold Coin","unit":"IRR","symbol":"gerami_coin","category":"coin"},{"name":"Tether (USDT)","unit":"IRR","symbol":"usdt","category":"crypto"}]},"meta":{"timestamp":"2026-06-10T22:57:52.846Z","request_id":"701b3a91-719d-4555-9690-eea70606780f"},"status":"ok","message":"Symbols retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Prices in IRR (rial); toman = rial / 10. Gold ounce quoted in USD.","source":"tgju.org market API (api.tgju.org, live)","service":"irr-api","usd_irr":1758050,"endpoints":{"GET /v1/gold":"Iran's gold market — ounce, 18k/24k gram and gold coins.","GET /v1/meta":"This document.","GET /v1/price":"One instrument's latest close/open/high/low, day change and date (symbol=usd).","GET /v1/history":"An instrument's daily OHLC series (symbol=usd, limit=30).","GET /v1/symbols":"All supported symbols.","GET /v1/currencies":"Every foreign currency vs the rial at once."},"description":"Live free-market (bazaar) prices for the Iranian rial against foreign currencies, gold and gold coins, from a public Iranian market feed. Iran's official rate is fixed and unused in practice; the real economy trades on the open bazaar rate exposed here. The price endpoint returns one instrument's latest close/open/high/low, day change and date (rial and toman); the currencies endpoint returns every foreign currency (USD, EUR, GBP, AED, TRY, CNY …) vs the rial at once; the gold endpoint returns the global ounce, 18k/24k gram and the famous gold coins (Emami, Bahar Azadi, half, quarter, gerami); the history endpoint returns an instrument's daily OHLC series. Live, no key, nothing stored. Distinct from official central-bank feeds and from other countries' parallel-dollar APIs — this is Iran's own free-market rial/gold/coin layer.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T22:57:54.330Z","request_id":"b9c1ea9f-c387-4a26-8e5c-1932f656573d"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":700,"monthly_call_quota":60000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":300000,"rps_limit":35,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5200,"monthly_call_quota":2000000,"rps_limit":110,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/irr-api"}