API و دادهٔ باز نرخ‌سنج
نرخ‌سنج سه نشانی باز دارد که رایگان، بدون کلید (API Key) و بدون ثبت‌نام خوانده می‌شوند: نرخ لحظه‌ای، آرشیو روزانه، و محاسبهٔ قیمت روز کالا. همهٔ مبلغ‌ها به تومان و نرخ بازار آزاد تهران است.
۱. نرخ لحظه‌ای
هر دقیقه به‌روز می‌شود. بیرون از ساعت بازار، نرخ پایانی آخرین روز کاری است و ساعت خالی می‌ماند.GET https://nerkh.jahankhahan.shop/data/live.json
| فیلد | معنی |
|---|---|
| date | تاریخ شمسی نرخ، مثل 1405/07/13 |
| time | ساعت آخرین تغییر به وقت تهران |
| rates.dollar | دلار آمریکا (الان ۲۶۸٬۷۹۰ تومان) |
| rates.euro / yuan | یورو و یوان چین |
| rates.gold / coin | هر گرم طلای ۱۸ عیار و سکهٔ امامی |
| change.* | درصد تغییر نسبت به روز قبل |
۲. آرشیو روزانه
نرخ پایانی هر روز کاری. روزهای تعطیل ردیف ندارند؛ برای آن‌ها نرخ آخرین روز کاری قبل را بگیرید.GET https://nerkh.jahankhahan.shop/data/rates.json
ساختار: series[] با فیلدهای key، name و days؛ هر عضو days یک جفت ["1404/07/15", 113970] است.
| کلید | معیار | از تاریخ |
|---|---|---|
| dollar | دلار آمریکا | ۱۳۹۰/۰۹/۰۵ |
| euro | یورو | ۱۳۹۱/۰۴/۰۸ |
| yuan | یوان چین | ۱۳۹۳/۰۴/۳۰ |
| gold | هر گرم طلای ۱۸ عیار | ۱۳۹۲/۰۴/۳۱ |
| coin | سکهٔ امامی | ۱۳۸۹/۰۱/۱۵ |
همین داده به‌صورت صفحهٔ خواندنی در آرشیو قیمت هست؛ نشانی هر ماه به شکل /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 (پیش‌فرض)، euro، yuan، gold یا coin |
| format | json برای داده؛ بدون آن صفحهٔ متنی |
فیلدهای پاسخ: rate_on_purchase_date، rate_now، ratio، replacement_cost (قیمت خرید به‌روز) و sell_prices. نمونهٔ خواندنی: محاسبهٔ کالای ۸۳۰ هزار تومانی خریداری‌شده در ۱۵ مهر ۱۴۰۴.
شرایط استفاده
رایگان است؛ فقط منصفانه استفاده کنید.هر نشانی را حداکثر دقیقه‌ای یک بار بخوانید؛ نرخ‌ها زودتر از آن عوض نمی‌شوند. هنگام نمایش عددها، نام «نرخ‌سنج» را به‌عنوان منبع بیاورید. این عددها برآورد بر پایهٔ نرخ ارز هستند و پیش‌بینی یا توصیهٔ مالی نیستند.