نِت اَرز · مستندات API نرخ ارز
همهٔ مستندات
تابلوی نرخ مرجع تعاملی کلید رایگان

تغییرات

تاریخچهٔ نسخه‌های API نرخ ارز نِت اَرز: endpointهای تازه مثل آرشیو روزانه، تغییر طرح رایگان و پرو، و قاعدهٔ نسخه‌بندی ما: فیلد موجود را حذف نمی‌کنیم.

base_url: https://netarz.ir/api/fx/v1 دلار امروز: ۲۷۳,۶۰۰ تومان به‌روزرسانی: 1405/07/05
نسخهتاریختغییرات
v1.2.0 5 مهر 1405 ارزهای ویژهٔ پرو:
  • سوم ازبکستان (UZS، برای هر ۱٬۰۰۰ سوم) و سامانی تاجیکستان (TJS) به فهرست اضافه شدند؛ فقط در طرح پرو.
  • آرشیو روزانهٔ هر دو: سامانی از ۱۳۷۹ و سوم از ۱۳۷۳. سامانی از شهریور ۱۳۹۷ نرخ بازار آزاد تهران است و پیش از آن، مثل همهٔ روزهای سوم، از دلار بازار آزاد همان روز و نرخ رسمی آن ارز محاسبه شده (source=derived).
  • /currencies فیلد pro_only دارد. طرح رایگان روی این ارزها خطای 402 pro_required می‌گیرد.
v1.1.0 28 شهریور 1405 آرشیو روزانهٔ نرخ ارز:
  • /archive/{code} در پرو: نرخ پایانی هر روز کاری با تاریخ شمسی و میلادی، یا نرخ یک تاریخ؛ JSON و CSV. دلار از ۱۳۶۰.
  • /history، /ohlc، /stats و /snapshot برای بازه‌های روزانه و قدیمی از همین آرشیو جواب می‌دهند (meta.resolution). بازه‌های تازهٔ 3y، 5y، 10y و all و interval=1mo.
  • /currencies فیلد archive_from دارد و /me فیلد features.archive.
  • تاریخچه از این نسخه فقط در طرح پرو است؛ طرح رایگان روی /history خطای 402 pro_required می‌گیرد.
v1.0.0 14 شهریور 1405 انتشار عمومی API نرخ ارز نِت اَرز:
  • /rates، /rates/{code}، /convert، /currencies، /status، /me
  • /history/{code} با JSON و CSV؛ /ohlc، /stats، /snapshot در پرو
  • هشدار قیمت با وبهوک امضاشده (/alerts) و استریم SSE (/stream) در پرو
  • قفل دامنه با اثبات مالکیت (DNS / well-known)، دامنه‌های اضافی و IP سرور
  • ویجت قابل‌جاسازی /fx/widget.js
  • طرح رایگان با نرخ تأخیردار و طرح پرو ماهانه به‌ازای هر اپ، پرداخت تومانی با نرخ روز

سیاست نسخه‌بندی

  • مسیر /api/fx/v1 پایدار است: فیلد جدید اضافه می‌کنیم، فیلد موجود را حذف یا تغییر معنا نمی‌دهیم.
  • تغییر ناسازگار = نسخهٔ جدید (v2) با دورهٔ همپوشانی دست‌کم ۶ ماه.
  • کدهای خطا و نام رویدادهای وبهوک ثابت می‌مانند؛ متن پیام‌ها ممکن است بهتر شود.