API و دادهٔ باز نرخسنج
نرخسنج سه نشانی باز دارد که رایگان، بدون کلید (API Key) و بدون ثبتنام خوانده میشوند: نرخ لحظهای، آرشیو روزانه، و محاسبهٔ قیمت روز کالا. همهٔ مبلغها به تومان و نرخ بازار آزاد تهران است. English version
۱. نرخ لحظهای
هر دقیقه بهروز میشود. بیرون از ساعت بازار، نرخ پایانی آخرین روز کاری است و ساعت خالی میماند.GET https://nerkh.jahankhahan.shop/data/live.json
| فیلد | معنی |
|---|---|
| date | تاریخ شمسی نرخ، مثل 1405/08/28 |
| time | ساعت آخرین تغییر به وقت تهران |
| rates.dollar | دلار آمریکا (الان ۲۶۹٬۹۷۰ تومان) |
| rates.euro / yuan | یورو و یوان چین |
| rates.gold / coin | هر گرم طلای ۱۸ عیار و سکهٔ امامی |
| rates.aed / lira / pound | درهم امارات، لیر ترکیه و پوند انگلیس |
| rates.tether / bitcoin | تتر و بیتکوین به تومان |
| rates.gold24 / bahar / half / quarter / gram | طلای ۲۴ عیار، سکهٔ بهار آزادی، نیمسکه، ربعسکه و سکهٔ گرمی |
| ounce | انس جهانی طلا به دلار |
| change.* | درصد تغییر نسبت به روز قبل |
۲. آرشیو روزانه
نرخ پایانی هر روز کاری. روزهای تعطیل ردیف ندارند؛ برای آنها نرخ آخرین روز کاری قبل را بگیرید.GET https://nerkh.jahankhahan.shop/data/rates.json
ساختار: series[] با فیلدهای key، name و days؛ هر عضو days یک جفت ["1404/07/15", 113970] است.
| کلید | معیار | از تاریخ |
|---|---|---|
| dollar | دلار آمریکا | ۱۳۹۰/۰۹/۰۵ |
| euro | یورو | ۱۳۹۱/۰۴/۰۸ |
| yuan | یوان چین | ۱۳۹۳/۰۴/۳۰ |
| gold | هر گرم طلای ۱۸ عیار | ۱۳۹۲/۰۴/۳۱ |
| coin | سکهٔ امامی | ۱۳۸۹/۰۱/۱۵ |
| aed | درهم امارات | ۱۳۹۱/۰۶/۱۱ |
| lira | لیر ترکیه | ۱۳۹۳/۰۴/۳۰ |
| pound | پوند انگلیس | ۱۳۹۱/۰۶/۱۱ |
| tether | تتر (USDT) | ۱۳۹۹/۰۸/۲۲ |
| bitcoin | بیتکوین | ۱۳۹۹/۰۸/۲۲ |
| gold24 | هر گرم طلای ۲۴ عیار | ۱۳۹۳/۰۲/۱۲ |
| bahar | سکهٔ بهار آزادی | ۱۳۹۲/۰۴/۳۱ |
| half | نیمسکه | ۱۳۹۲/۰۴/۳۱ |
| quarter | ربعسکه | ۱۳۹۲/۰۴/۳۱ |
| gram | سکهٔ گرمی | ۱۳۹۲/۰۴/۳۱ |
| cad | دلار کانادا | ۱۳۹۳/۰۴/۳۰ |
| aud | دلار استرالیا | ۱۳۹۳/۰۴/۳۰ |
| chf | فرانک سوئیس | ۱۳۹۳/۰۴/۳۰ |
| sar | ریال عربستان | ۱۳۹۳/۰۴/۳۰ |
| qar | ریال قطر | ۱۳۹۳/۰۴/۳۰ |
| kwd | دینار کویت | ۱۳۹۳/۰۴/۳۰ |
| omr | ریال عمان | ۱۳۹۳/۰۴/۳۰ |
| iqd | دینار عراق | ۱۳۹۳/۰۵/۰۱ |
| afn | افغانی افغانستان | ۱۳۹۳/۰۴/۳۰ |
| rub | روبل روسیه | ۱۳۹۳/۰۴/۳۰ |
| inr | روپیهٔ هند | ۱۳۹۳/۰۴/۳۰ |
| mesghal | مثقال طلا | ۱۳۹۲/۰۴/۳۱ |
| silver | هر گرم نقرهٔ ۹۹۹ | ۱۳۹۹/۰۸/۱۰ |
همین داده بهصورت صفحهٔ خواندنی در آرشیو قیمت هست؛ نشانی هر ماه به شکل /dollar/1404/07/ است.
۳. محاسبهٔ قیمت روز کالا با یک نشانی
نتیجه یا بهصورت صفحهٔ متنی ساده میآید یا با format=json بهصورت داده.GET https://nerkh.jahankhahan.shop/calc?price=830000&date=1404/07/15&margin=20&format=json
| پارامتر | معنی |
|---|---|
| price | قیمت خرید به تومان (اجباری) |
| date | تاریخ خرید شمسی، مثل 1404/07/15 (اجباری) |
| margin | درصد سود فروش؛ اگر نباشد قیمت فروش با ۱۰، ۲۰ و ۳۰ درصد برمیگردد |
| adj | درصد تعدیل بازار همان کالا؛ میتواند منفی باشد |
| series | معیار: dollar (پیشفرض) یا هر کلید دیگر جدول آرشیو، مثل aed یا lira |
| format | json برای داده؛ بدون آن صفحهٔ متنی |
فیلدهای پاسخ: rate_on_purchase_date، rate_now، ratio، replacement_cost (قیمت خرید بهروز) و sell_prices. نمونهٔ خواندنی: محاسبهٔ کالای ۸۳۰ هزار تومانی خریداریشده در ۱۵ مهر ۱۴۰۴.
۴. نرخ درونروزی و ماشینحساب طلا
کمترین و بیشترین امروز و نقطههای دهدقیقهای هر معیار؛ و ارزش ذاتی و حباب طلا و سکه.GET https://nerkh.jahankhahan.shop/data/intraday.json
ساختار: series.dollar.low، high و points که هر عضوش جفت ["14:20", 268700] است. فایل با شروع هر روز کاری از نو ساخته میشود. صفحهٔ خواندنی: نرخ امروز.
GET https://nerkh.jahankhahan.shop/gold-calculator?format=json
ارزش ذاتی و حباب هر گرم طلا و هر سکه از روی انس جهانی و دلار. با weight، karat، wage، profit و tax قیمت زیورآلات با اجرت هم برمیگردد. صفحهٔ خواندنی: ماشینحساب طلا.
۵. مبدل ارز
تبدیل هر معیار به تومان یا به معیار دیگر با نرخ لحظهای.GET https://nerkh.jahankhahan.shop/convert/dollar-to-toman?amount=100&format=json
نشانی به شکل /convert/{from}-to-{to} است؛ from و to کلید معیار یا toman هستند. پاسخ rate و result دارد. انس جهانی طلا و نقره به دلار در /data/rates-usd.json و فیلد usd نرخ لحظهای هستند.
۶. ارزش پول، مقایسهٔ دو تاریخ و نرخ متنی
سه نشانی کمکی که همان داده را به شکل آماده میدهند.GET https://nerkh.jahankhahan.shop/value?amount=10000000&date=1398/01/15&format=json
ارزش امروزِ یک مبلغ از گذشته، بر پایهٔ دلار، یورو، طلا و سکه.
GET https://nerkh.jahankhahan.shop/compare?from=1403/01/15&to=1405/07/14&format=json
درصد تغییر همهٔ معیارها بین دو تاریخ، از بیشترین به کمترین. اگر to نباشد، تا امروز.
GET https://nerkh.jahankhahan.shop/rate/dollar · GET https://nerkh.jahankhahan.shop/rate/dollar/1403/07/15
فقط یک عدد بهصورت متن ساده؛ مناسب اکسل و گوگلشیت (راهنما). نرخ همهٔ معیارها در یک روز مشخص هم بهصورت صفحهٔ خواندنی در /date/1403/07/15/ هست.
شرایط استفاده
رایگان است؛ فقط منصفانه استفاده کنید.هر نشانی را حداکثر دقیقهای یک بار بخوانید؛ نرخها زودتر از آن عوض نمیشوند. برای قیمتگذاری چند کالا، live.json را یک بار بخوانید و خودتان ضرب کنید؛ برای هر کالا جدا /calc را صدا نزنید. نمونهکد آماده برای PHP، پایتون، جاوااسکریپت، وردپرس و گوگلشیت در مخزن گیتهاب نرخسنج است. هنگام نمایش عددها، نام «نرخسنج» را بهعنوان منبع بیاورید. این عددها برآورد بر پایهٔ نرخ ارز هستند و پیشبینی یا توصیهٔ مالی نیستند.