Free, keyless JSON data from Nerkhsanj (نرخسنج): live Tehran free-market rates for 28 series (US dollar, euro, pound, UAE dirham, Turkish lira, Chinese yuan and eleven more regional currencies, Tether, Bitcoin, gold, silver and five gold coins), a daily archive going back to 2010, intraday points, a currency converter, a gold calculator, and a calculator that tells you what an item bought in the past costs today.
No API key, no sign-up. All amounts are in Iranian toman (1 toman = 10 rial). Dates are Jalali (Solar Hijri), written 1404/07/15.
راهنمای فارسی پایین همین صفحه است.
| Endpoint | What it returns | Updated |
|---|---|---|
GET https://nerkh.jahankhahan.shop/data/live.json |
Current rate of all 28 toman series, plus world gold and silver ounce prices in USD | Every minute |
GET https://nerkh.jahankhahan.shop/data/intraday.json |
Today's low, high and ten-minute points per series | Every minute in market hours |
GET https://nerkh.jahankhahan.shop/data/rates.json |
Closing rate of every trading day | Three times a day |
GET https://nerkh.jahankhahan.shop/calc?price=…&date=…&format=json |
Replacement cost and sell price of one item | Live |
GET https://nerkh.jahankhahan.shop/gold-calculator?format=json |
Intrinsic value and premium of gold and coins; jewelry price with wage, profit and tax | Live |
GET https://nerkh.jahankhahan.shop/convert/dollar-to-toman?amount=100&format=json |
Convert between toman and any series, or between two series | Live |
GET https://nerkh.jahankhahan.shop/value?amount=…&date=…&format=json |
What an amount from the past is worth today, by dollar, euro, gold and coin | Live |
GET https://nerkh.jahankhahan.shop/compare?from=…&to=…&format=json |
Percent change of every series between two dates | Live |
GET https://nerkh.jahankhahan.shop/rate/dollar and /rate/dollar/1403/07/15 |
One number as plain text, for Excel WEBSERVICE and Google Sheets IMPORTDATA |
Live |
GET https://nerkh.jahankhahan.shop/data/rates-usd.json |
Daily archive of the world gold and silver ounce in USD | Three times a day |
Full reference: English · فارسی
{
"date": "1405/07/13",
"time": "19:35",
"rates": { "dollar": 268790, "euro": 302660, "yuan": 40380, "gold": 26528700, "coin": 271160000, "aed": 73403, "tether": 268649 },
"change": { "dollar": 0.43, "euro": -0.1, "yuan": 0.45, "gold": 0.76, "coin": 0.03, "aed": -0.05, "tether": 0.06 },
"ounce": 4129.98
}The example is shortened; the real file carries all 28 keys, and a usd object with ounce and silver-ounce. time is empty outside market hours; the rates are then the last trading day's close. change is the percent change against the previous day. ounce is the world gold price per troy ounce in US dollars.
{ "series": [ { "key": "dollar", "name": "دلار", "days": [ ["1390/09/05", 1345], ["1404/07/15", 113970] ] } ] }| Key | Series | From (Jalali) |
|---|---|---|
dollar |
US dollar | 1390 |
euro |
Euro | 1391 |
aed |
UAE dirham | 1391 |
pound |
British pound | 1391 |
yuan |
Chinese yuan | 1393 |
lira |
Turkish lira | 1393 |
tether |
Tether (USDT) | 1399 |
bitcoin |
Bitcoin | 1399 |
gold |
18k gold, per gram | 1392 |
gold24 |
24k gold, per gram | 1393 |
coin |
Emami gold coin | 1389 |
bahar |
Bahar Azadi gold coin | 1392 |
half |
Half coin | 1392 |
quarter |
Quarter coin | 1392 |
gram |
One-gram coin | 1392 |
mesghal |
Gold mesghal (4.6083 g) | 1392 |
silver |
Silver 999, per gram | 1399 |
cad, aud, chf |
Canadian dollar, Australian dollar, Swiss franc | 1393 |
sar, qar, kwd, omr |
Saudi riyal, Qatari riyal, Kuwaiti dinar, Omani rial | 1393 |
iqd, afn, rub, inr |
Iraqi dinar, Afghan afghani, Russian ruble, Indian rupee | 1393 |
Holidays have no row; use the last earlier trading day.
GET https://nerkh.jahankhahan.shop/calc?price=830000&date=1404/07/15&margin=20&format=json
| Parameter | Meaning |
|---|---|
price |
Purchase price in toman (required) |
date |
Purchase date, Jalali (required) |
margin |
Profit margin in percent. If omitted, sell prices for 10, 20 and 30 percent are returned |
adj |
Market adjustment in percent for that item; may be negative |
series |
dollar (default) or any other key from the table above, e.g. aed or lira |
format |
json for data. Without it you get a readable HTML page that needs no JavaScript |
The response carries rate_on_purchase_date, rate_now, ratio, replacement_cost and sell_prices.
Formula: replacement_cost = price × (rate_now ÷ rate_on_purchase_date).
- Widget: show live rates on any site with two lines of HTML. Builder: nerkh.jahankhahan.shop/widget
- WooCommerce plugin: keeps product prices in step with the exchange rate from each product's purchase price and date. Download: nerkh.jahankhahan.shop/woocommerce
- WordPress rates plugin: a
[nerkhsanj]shortcode and a sidebar widget, rendered server-side. Download from the same widget page - Excel and Google Sheets: one-formula rates, no add-on needed: nerkh.jahankhahan.shop/excel
- Currency converter: nerkh.jahankhahan.shop/convert
- Today's rates page: nerkh.jahankhahan.shop/today
<div data-nerkhsanj data-series="dollar,euro,gold,coin"><a href="https://nerkh.jahankhahan.shop/">نرخسنج</a></div>
<script async src="https://nerkh.jahankhahan.shop/widget.js"></script>| File | Shows |
|---|---|
| examples/python_example.py | Live rate, archive lookup, pricing many items with one request |
| examples/node_example.mjs | The same with Node.js 18+ |
| examples/php_example.php | The same with plain PHP |
| examples/wordpress_snippet.php | A [nerkh_rate] shortcode with one-minute caching |
| examples/google_sheets.gs | =NERKH("dollar") and =NERKH_REPLACEMENT(830000,"1404/07/15") |
- Read each endpoint at most once a minute. Rates do not change faster than that.
- To price many items, read
live.jsonandrates.jsononce and multiply yourself. Do not call/calconce per item. - Credit "Nerkhsanj" as the source when you show the numbers.
- Only the
/calcJSON response allows cross-origin browser requests. Read the two data files from your server. - The figures are exchange-rate-based estimates, not forecasts or financial advice.
The example code in this repository is released under the MIT license.
نرخسنج دادهٔ نرخ بازار آزاد تهران را رایگان، بدون کلید (API Key) و بدون ثبتنام میدهد: ۲۸ معیار شامل دلار، یورو، پوند، درهم، لیر، یوان و یازده ارز دیگر منطقه، تتر، بیتکوین، طلای ۱۸ و ۲۴ عیار، مثقال، نقره و پنج نوع سکه؛ بهعلاوهٔ انس جهانی طلا و نقره به دلار. همهٔ مبلغها به تومان و تاریخها شمسی است.
- نرخ لحظهای (هر دقیقه):
https://nerkh.jahankhahan.shop/data/live.json - آرشیو روزانه (نرخ پایانی هر روز کاری، دلار از آذر ۱۳۹۰ و سکه از فروردین ۱۳۸۹):
https://nerkh.jahankhahan.shop/data/rates.json - نرخ درونروزی (کمترین، بیشترین و نقطههای دهدقیقهای امروز):
https://nerkh.jahankhahan.shop/data/intraday.json - محاسبهٔ قیمت روز کالا:
https://nerkh.jahankhahan.shop/calc?price=830000&date=1404/07/15&margin=20&format=json - ماشینحساب طلا (ارزش ذاتی و حباب طلا و سکه، قیمت با اجرت):
https://nerkh.jahankhahan.shop/gold-calculator?format=json - مبدل ارز:
https://nerkh.jahankhahan.shop/convert/dollar-to-toman?amount=100&format=json - ارزش پول سالهای قبل:
https://nerkh.jahankhahan.shop/value?amount=10000000&date=1398/01/15&format=json - مقایسهٔ رشد معیارها بین دو تاریخ:
https://nerkh.jahankhahan.shop/compare?from=1403/01/15&format=json - نرخ بهصورت متن ساده برای اکسل و گوگلشیت:
https://nerkh.jahankhahan.shop/rate/dollarوhttps://nerkh.jahankhahan.shop/rate/dollar/1403/07/15
پارامترهای محاسبه: price قیمت خرید به تومان، date تاریخ خرید شمسی، margin درصد سود (اختیاری)، adj درصد تعدیل بازار (اختیاری)، series یکی از کلیدهای جدول بالا، مثل dollar، aed یا lira.
فرمول: قیمت خرید بهروز = قیمت خرید × (نرخ امروز ÷ نرخ روز خرید).
مستندات کامل: nerkh.jahankhahan.shop/developers
- ابزارک نمایش نرخ برای سایتهای دیگر با دو خط کد
- افزونهٔ ووکامرس برای بهروزرسانی خودکار قیمت محصولات
- نرخ امروز همهٔ معیارها در یک صفحه
پوشهٔ examples نمونهٔ آماده برای پایتون، Node.js، PHP، وردپرس (کد کوتاه [nerkh_rate]) و گوگلشیت دارد.
- هر نشانی را حداکثر دقیقهای یک بار بخوانید.
- برای قیمتگذاری چند کالا، دو فایل داده را یک بار بخوانید و خودتان ضرب کنید؛ برای هر کالا جدا
/calcرا صدا نزنید. - هنگام نمایش عددها، «نرخسنج» را بهعنوان منبع بیاورید.
- این عددها برآورد بر پایهٔ نرخ ارز هستند، نه پیشبینی یا توصیهٔ مالی.