رفتن به محتوای اصلی
سرویکس وب‌سرویس و API داده‌های بازار ایران

وب‌سرویس نرخ ارز با احراز هویت

وب‌سرویس و API نرخ ارز ایران برای توسعه‌دهندگان

با وب‌سرویس سرویکس و کلید API می‌توانید نرخ دلار، یورو و درهم را از اندپوینت‌های نسخه یک در ربات، داشبورد یا بک‌اند دریافت کنید. این مرکز مسیرهای مستند هر نماد و قرارداد ریالی آن‌ها را جمع می‌کند.

قیمت عمومی فقط در تصویر تولیدشده در سرور دیده می شود. endpointهای نسخه یک با API Key پاسخ JSON پایدار شامل code، value و businessTime می دهند و برای ربات، داشبورد، backend و ابزار پایش مناسب هستند.

همه جفت های این مجموعه، ریال ایران برای یک واحد ارز پایه را گزارش می کنند.

برای دریافت کلید API حساب بسازید مشاهده قیمت و پلن ها

آخرین قیمت ثبت شده

نمای تصویری گروه ارزهای منتخب سرویکس
تصویر گروهی نرخ های ارز منتخب سرویکس

دارایی های تایید شده این مجموعه

نمونه استفاده از API

برای snapshot همه نمادها از GET /api/v1/assets، برای چند نماد از پارامتر codes و برای یک نماد از مسیر تک نماد استفاده کنید. API Key باید در هدر X-API-Key ارسال شود.

نمونه درخواست

curl -sS https://servix.cc/api/v1/assets \
  -H "X-API-Key: pk_live_your_key_here"

نمونه پاسخ

[{
  "code": "USD_RLS",
  "name": "USD_RLS",
  "slug": "usd_rls",
  "labelEn": "US Dollar / Iranian Rial",
  "labelFa": "دلار آمریکا / ریال ایران",
  "quoteUnit": "RLS",
  "value": "<protected-market-value>",
  "businessTime": "<source-timestamp>"
}]

روش محاسبه و تازگی داده

تصویر عمومی از آخرین رکورد پذیرفته شده نمادهای RLS ساخته می شود. قرارداد اصلی API ریال ایران است، تازگی از businessTime سنجیده می شود و وضعیت قدیمی یا مفقود کنار تصویر اعلام می شود.

کاربردهای پیشنهادی

  • ساخت ربات اعلام نرخ ارز با cache سمت سرور
  • نمایش قیمت در داشبورد مالی و ابزار حسابداری
  • ثبت تاریخچه و ایجاد هشدار تغییر قیمت برای محصول فین تک

پرسش های متداول

واحد قیمت های این صفحه چیست؟
مقدار اصلی API ریال ایران است و تومان از تقسیم همان مقدار بر ۱۰ به دست می آید.
آیا قیمت ها لحظه ای هستند؟
زمان businessTime و وضعیت تازگی مشخص می کند آخرین رکورد چه زمانی ثبت شده است؛ پاسخ موفق به تنهایی تضمین لحظه ای بودن نیست.
چرا برای استفاده نرم افزاری API لازم است؟
API قرارداد JSON و احراز هویت مشخص دارد؛ scraping صفحه برای سیستم عملیاتی پایدار و توصیه شده نیست.

صفحه ها و راهنماهای مرتبط

وب‌سرویس و API قیمت دلار به ریال و تومانوب‌سرویس و API قیمت یورو به ریال و تومانوب‌سرویس و API قیمت درهم به ریال و تومانوب‌سرویس و API قیمت طلا برای اپلیکیشن‌های ایرانیوب‌سرویس و API قیمت سکه امامی برای اپلیکیشن‌هامطالعه مستندات APIمشاهده نمادهای پشتیبانی‌شدهمشاهده قیمت و پلن ها
برای دریافت کلید API حساب بسازید مطالعه مستندات API