روش شناسی داده های ارز، طلا، سکه و رمزارز سرویکس

این صفحه توضیح می دهد مقدار و زمان داده در سرویکس چگونه نمایش داده می شود. هدف، کمک به طراحی یکپارچه سازی ای است که قدیمی شدن داده، تفاوت واحدها و محدودیت منابع بیرونی را به درستی مدیریت کند.

کد نماد و واحد قیمت

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

زمان ها چه معنایی دارند؟

فیلد businessTime زمان مربوط به قیمت دریافت شده است، نه زمان ارسال درخواست شما. کاتالوگ supported علاوه بر آن می تواند sourceTime و insertTime را برای تفکیک زمان منبع و زمان ثبت داخلی برگرداند. اختلاف این زمان ها لزوما به معنی خطا نیست، اما باید در پایش تازگی لحاظ شود.

به روزرسانی و داده قدیمی

دریافت داده به صورت دوره ای و با تنظیمات عملیاتی انجام می شود؛ بنابراین سرویکس قیمت لحظه ای یا فاصله ثابت و بدون وقفه را تضمین نمی کند. اندپوینت /api/v1/assets/supported آستانه تازگی را با staleThresholdMinutes و وضعیت هر نماد را با availabilityStatus و stale اعلام می کند. این آستانه قابل تنظیم است و نباید در کلاینت به صورت عدد ثابت فرض شود.

تعطیلی یا توقف بازار

سرویکس تقویم باز و بسته بودن همه بازارها را به پاسخ قیمت تحمیل نمی کند. وقتی بازار، نماد یا منبع به روز نشود، آخرین مقدار ثبت شده می تواند همچنان برگردد و businessTime قدیمی بماند. کلاینت باید زمان و وضعیت stale را نمایش دهد و از تعبیر هر پاسخ به عنوان معامله جاری خودداری کند.

انتخاب آخرین مقدار و اصلاح ها

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

داده تاریخی

API مسیر روز مشخص و مسیر history برای بازه تاریخ دارد. هر درخواست بازه حداکثر ۳۱ روز را می پذیرد؛ این محدودیت طول درخواست است و درباره قدمت کل آرشیو تضمینی ایجاد نمی کند. وجود داده برای هر روز یا هر نماد به تاریخ شروع ثبت، فعالیت بازار و دسترسی منبع بستگی دارد.

منابع و محدودیت ها

قیمت ها از تامین کننده بیرونی دریافت و سپس ذخیره، کنترل تکرار، برچسب گذاری کیفیت و برای دسترسی سریع آماده می شوند. تاخیر منبع، نبود یک نماد، تغییر فرمت، قطعی شبکه، تفاوت بازارها یا اصلاح بعدی می تواند روی خروجی اثر بگذارد. فهرست providers در کاتالوگ supported پوشش فنی اعلام شده را نشان می دهد و تضمین کیفیت یا دسترس پذیری دائمی نیست.

راهنمای استفاده مسئولانه

• businessTime و وضعیت stale را همراه مقدار ذخیره و نمایش دهید؛
• برای داده قدیمی، ناموجود یا دارای هشدار مسیر جایگزین و اعلان تعریف کنید؛
• برای تصمیم مالی، تسویه، معامله یا گزارش رسمی، داده را با منبع مستقل تطبیق دهید؛
• برای گزارش ناسازگاری، کد نماد، زمان، مقدار و مسیر API را از صفحه تماس ارسال کنید.

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

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