دلار…

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
formatjson برای داده؛ بدون آن صفحهٔ متنی

فیلدهای پاسخ: 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، پایتون، جاوااسکریپت، وردپرس و گوگل‌شیت در مخزن گیت‌هاب نرخ‌سنج است. هنگام نمایش عددها، نام «نرخ‌سنج» را به‌عنوان منبع بیاورید. این عددها برآورد بر پایهٔ نرخ ارز هستند و پیش‌بینی یا توصیهٔ مالی نیستند.