API و دادهٔ باز نرخ‌سنج
نرخ‌سنج سه نشانی باز دارد که رایگان، بدون کلید (API Key) و بدون ثبت‌نام خوانده می‌شوند: نرخ لحظه‌ای، آرشیو روزانه، و محاسبهٔ قیمت روز کالا. همهٔ مبلغ‌ها به تومان و نرخ بازار آزاد تهران است. English version
۱. نرخ لحظه‌ای
هر دقیقه به‌روز می‌شود. بیرون از ساعت بازار، نرخ پایانی آخرین روز کاری است و ساعت خالی می‌ماند.GET https://nerkh.jahankhahan.shop/data/live.json
| فیلد | معنی |
|---|---|
| date | تاریخ شمسی نرخ، مثل 1405/07/13 |
| 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 | سکهٔ گرمی | ۱۳۹۲/۰۴/۳۱ |
همین داده به‌صورت صفحهٔ خواندنی در آرشیو قیمت هست؛ نشانی هر ماه به شکل /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 قیمت زیورآلات با اجرت هم برمی‌گردد. صفحهٔ خواندنی: ماشین‌حساب طلا.
شرایط استفاده
رایگان است؛ فقط منصفانه استفاده کنید.هر نشانی را حداکثر دقیقه‌ای یک بار بخوانید؛ نرخ‌ها زودتر از آن عوض نمی‌شوند. برای قیمت‌گذاری چند کالا، live.json را یک بار بخوانید و خودتان ضرب کنید؛ برای هر کالا جدا /calc را صدا نزنید. نمونه‌کد آماده برای PHP، پایتون، جاوااسکریپت، وردپرس و گوگل‌شیت در مخزن گیت‌هاب نرخ‌سنج است. هنگام نمایش عددها، نام «نرخ‌سنج» را به‌عنوان منبع بیاورید. این عددها برآورد بر پایهٔ نرخ ارز هستند و پیش‌بینی یا توصیهٔ مالی نیستند.