قیمت های جاری

دریافت قیمت جاری ارز، طلا، سکه و رمزارز

با endpointهای قیمت جاری Servix آخرین مقدار همه نمادها یا یک نماد مانند USD_RLS، GOLD_18_RLS و BTC_USD را همراه businessTime دریافت کنید.

برای دریافت آخرین مقدار ثبت شده دو انتخاب دارید: همه نمادها را در یک پاسخ بگیرید یا فقط یک کد مشخص را درخواست کنید. هر دو مسیر به API Key معتبر و دسترسی فعال نیاز دارند.

آخرین قیمت همه نمادها

GET /api/v1/assets

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

خروجی یک آرایه از قیمت ها است. این مسیر برای cache کردن یک snapshot مشترک در ربات، داشبورد یا سرویس داخلی مناسب است. اگر فقط یک نماد لازم دارید، مسیر تک نماد داده کمتری منتقل می کند.

آخرین قیمت یک نماد

GET /api/v1/assets/{assetName}

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

assetName باید یکی از کدهای کاتالوگ باشد. چند نمونه پرکاربرد عبارت اند از USD_RLS برای دلار به ریال، EUR_RLS برای یورو به ریال، GOLD_18_RLS برای طلای ۱۸ عیار، SEKKEH_RLS برای سکه و BTC_USD برای بیت کوین به دلار.

ساختار پاسخ قیمت

فیلد	معنا	نکته مصرف
code	کد پایدار نماد	برای کلید cache و نگاشت داخلی استفاده کنید.
name	نام سازگار با نسخه قبلی	در حال حاضر با code برابر است.
slug	کد با حروف کوچک	برای نمایش یا URL داخلی خودتان مناسب است.
labelEn و labelFa	برچسب نمایشی	برای رابط فارسی از labelFa استفاده کنید.
value	مقدار عددی قیمت	واحد را از پسوند کد بخوانید.
businessTime	زمان مربوط به قیمت	تازگی را با این زمان بسنجید، نه زمان پاسخ HTTP.

ریال، تومان و دلار

نمادهای پایان یافته به _RLS در API بر حسب ریال ایران هستند. اگر رابط شما تومان نمایش می دهد، مقدار را با قاعده مشخص و شفاف بر ۱۰ تقسیم و واحد را کنار عدد نمایش دهید. نمادهای پایان یافته به _USD مانند BTC_USD دلاری هستند. جزئیات بیشتر در روش شناسی داده آمده است.

تازگی و cache

پاسخ موفق به معنی لحظه ای بودن قیمت نیست. تعطیلی بازار، توقف نماد یا اختلال منبع می تواند businessTime را قدیمی نگه دارد. پیش از استفاده عملیاتی، endpoint کاتالوگ را طبق راهنمای نمادها و وضعیت stale بررسی کنید. در سامانه پرترافیک، پاسخ را در بک اند cache کنید و به جای فراخوانی Servix از هر مرورگر، داده را از سرویس خودتان به کاربران بدهید.

انتخاب الگوی فراخوانی

برای رباتی که چند قیمت را در یک پیام منتشر می کند، GET /api/v1/assets و یک cache کوتاه مناسب است؛
برای هشدار یک نماد، مسیر تک نماد ساده تر و کم حجم تر است؛
برای نمودار و مقایسه زمانی، از endpointهای تاریخی استفاده کنید؛
برای تست قرارداد، مجموعه Postman را import کنید.

هر درخواست محافظت شده سهمیه روزانه مصرف می کند. قبل از افزایش تناوب polling، پلن ها و قواعد سهمیه را بررسی کنید.

صفحه های عمومی قیمت طلا و سکه

برای مشاهده قرارداد واحد، تصویر آخرین قیمت، زمان تجاری، وضعیت تازگی و مسیر دریافت تاریخچه با API Key، مرکز API قیمت طلا و صفحه قیمت طلای ۱۸ عیار را ببینید. برای داده سکه نیز مرکز API قیمت سکه و صفحه قیمت سکه امامی در دسترس است.

نمونه کاربردی ربات تلگرام

برای تبدیل این پاسخ به پیام فارسی همراه کنترل stale، cache و retry محدود، راهنمای ساخت ربات قیمت تلگرام را اجرا کنید.