نرخ ارز ایران برای توسعه دهندگان و محصولات مالی

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

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

برای snapshot همه نمادها از GET /api/v1/assets استفاده کنید یا مسیر تک نماد را برای کاهش حجم پاسخ فراخوانی کنید. 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",
  "labelFa": "دلار آمریکا / ریال ایران",
  "value": "<protected-market-value>",
  "businessTime": "<source-timestamp>"
}]

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

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

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

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

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

واحد قیمت های این صفحه چیست؟

مقدار اصلی API ریال ایران است و تومان از تقسیم همان مقدار بر ۱۰ به دست می آید.

آیا قیمت ها لحظه ای هستند؟

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

چرا برای استفاده نرم افزاری API لازم است؟

API قرارداد JSON و احراز هویت مشخص دارد؛ scraping صفحه برای سیستم عملیاتی پایدار و توصیه شده نیست.

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