وبسرویس دلار با احراز هویت
وبسرویس و API قیمت دلار به ریال و تومان
با وبسرویس سرویکس و کلید API میتوانید نرخ و تاریخچه USD_RLS را بهصورت ساختاریافته در ربات، داشبورد یا بکاند دریافت کنید. پیشنمایش عمومی بازار ارز فقط بهصورت تصویر گروهی تولیدشده روی سرور نمایش داده میشود.
USD/IRR یکی از پرکاربردترین ورودی ها برای داشبورد مالی، ربات اعلام قیمت، تبدیل مبلغ و پایش تغییرات بازار ایران است. زمان کنار تصویر، زمان تجاری snapshot است و برای سنجش تازگی داده استفاده می شود.
جهت نرخ: ریال ایران برای هر ۱ دلار آمریکا
آخرین قیمت ثبت شده
آخرین قیمت ثبت شده
نمونه استفاده از API
برای دریافت همین نرخ در قالب JSON، نماد USD_RLS را با API Key از endpoint تک نماد بخوانید. value بر حسب ریال و businessTime زمان تجاری رکورد است.
نمونه درخواست
curl -sS https://servix.cc/api/v1/assets/USD_RLS \
-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>"
}روش محاسبه و تازگی داده
سرویکس تصویر عمومی را از آخرین رکورد پذیرفته شده منبع فعال بر اساس زمان تجاری می سازد. تعطیلی بازار یا وقفه منبع ممکن است snapshot را stale کند؛ مقدار و تاریخچه ساختاریافته فقط با API Key در دسترس است.
کاربردهای پیشنهادی
- نمایش نرخ دلار در ربات تلگرام یا پیام رسان
- به روزرسانی داشبورد فروش، حسابداری یا تبدیل ارز
- پایش تغییرات USD/IRR و ساخت هشدار سمت سرور
پرسش های متداول
- قیمت دلار در API ریال است یا تومان؟
- فیلد value برای نماد USD_RLS ریال ایران است. تومان فقط با تقسیم همان عدد بر ۱۰ نمایش داده می شود.
- وضعیت stale چه معنایی دارد؟
- یعنی رکورد مبنای تصویر از آستانه تازگی سرویکس قدیمی تر است. زمان و وضعیت کنار تصویر را بررسی کنید و مقدار ساختاریافته را فقط با API Key بخوانید.
- آیا می توان تاریخچه نرخ دلار را از API گرفت؟
- بله. endpoint تاریخچه بازه حداکثر ۳۱ روز را می پذیرد و ممکن است برای روزهای بدون رکورد، ردیفی برنگرداند.