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

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

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

وب‌سرویس و API نرخ ارز ایران برای توسعه‌دهندگان — اطلاعات نمادها، واحد قیمت و کاربرد داده در این صفحه معرفی می‌شود.

برای دریافت مقدار و تاریخچه ساختاریافته، از 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>",
  "midPrice": "<protected-market-value>",
  "buyPrice": "<protected-market-value>",
  "sellPrice": "<protected-market-value>"
}]

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

داده بازار از آخرین رکورد پذیرفته‌شده منبع فعال گردآوری می‌شود. زمان businessTime و وضعیت تازگی را در پاسخ API احرازشده بررسی کنید؛ پاسخ موفق به‌تنهایی به معنای داده لحظه‌ای نیست.

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

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

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

چگونه داده بازار را در نرم‌افزار دریافت کنم؟
از اندپوینت‌های مستند سرویکس با کلید API معتبر استفاده کنید. واحد، جهت نرخ و زمان businessTime را برای تفسیر مقدار و تازگی هر رکورد بررسی کنید.

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