پاسخ قیمت‌های جاری

برای آخرین رکوردها از GET /api/v1/assets و برای یک دارایی از GET /api/v1/assets/{assetName} استفاده کنید. هر دو مسیر به کلید API معتبر نیاز دارند.

قرارداد دقیق پاسخ

همهٔ رکوردهای قیمت جاری همان فیلدهای قرارداد اصلی سرویس را دارند. quoteUnit مرجع واحد است؛ ریال، دلار یا شاخص را از روی پسوند نماد یا برچسب ترجمه‌شده حدس نزنید.

{
  "code": "USD_RLS",
  "name": "USD_RLS",
  "slug": "usd_rls",
  "labelEn": "US Dollar / Iranian Rial",
  "labelFa": "دلار آمریکا / ریال ایران",
  "quoteUnit": "RLS",
  "value": "<protected-market-value>",
  "businessTime": "<source-timestamp>",
  "buyPrice": "<protected-market-value>",
  "sellPrice": "<protected-market-value>",
  "midPrice": "<protected-market-value>"
}

دریافت چند نماد انتخابی

پارامتر اختیاری codes حداکثر ۱۰۰ کد نماد متمایز را با همان ترتیب درخواست برمی‌گرداند. کدهای تکراری حذف می‌شوند و انتخاب خالی، کد ناشناخته یا بیش از ۱۰۰ کد با خطای مستند HTTP 400 رد می‌شود. این فراخوانی مانند دریافت فهرست کامل، فقط یک واحد از سهمیه مصرف می‌کند. برای کدها، دسته‌بندی و واحدها، کاتالوگ احرازشده را مرجع قرار دهید.

GET /api/v1/assets?codes=USD_RLS,EUR_RLS,GOLD_18_RLS

استفاده از قیمت‌های انتخابی در Vue

راهنمای اجرایی Vue 3، Pinia و Composition API این مسیر را از طریق یک بک‌اند امن فراخوانی می‌کند، همهٔ فیلدهای پاسخ را می‌سنجد و وضعیت‌های بارگذاری، پاسخ خالی، پایان سهمیه و خطا را روشن و جداگانه مدیریت می‌کند.

تازگی و کش

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

کار تعاملی در پنل: برای انتخاب چند دارایی، دیدن جدول بعد از تأیید سهمیه و دریافت Excel یا JSON، معرفی کاوشگر داده بازار را بخوانید.

قیمت خرید و فروش همان مشاهده

قیمت سمت‌های مشاهدهٔ ذخیره‌شده: buyPrice قیمت خرید فروشنده از مشتری و sellPrice قیمت فروش به مشتری است. هر سمت متعلق به همان مشاهدهٔ value با همان quoteUnit و businessTime است و به صورت عدد دقیق JSON یا، در صورت ذخیره‌نشدن، صریحاً null برمی‌گردد. در مشاهده‌های قدیمی ممکن است یک یا هر دو سمت ناموجود باشند. قیمت میانی، قیمت قبلی یا قیمت فعلی جایگزین نمی‌شود. calendar=persian فقط تاریخ مسیر را به همان روز میلادی تبدیل می‌کند؛ include=ohlc کندل قیمت میانی را اضافه می‌کند و مشاهدهٔ انتخاب‌شده را تغییر نمی‌دهد. مسیر GET تاریخچه و بازهٔ POST معادل، آخرین مشاهدهٔ انتخاب‌شدهٔ هر روز موجود در نتیجهٔ جست‌وجوی قبلی را برمی‌گردانند؛ روز ناموجود پر نمی‌شود. این تغییر دادهٔ تاریخی تامین‌کننده را دریافت یا بازسازی نمی‌کند.

نمونهٔ مشاهدهٔ ذخیره‌شده (مقادیر محافظت‌شده):

{
  "code": "USD_RLS",
  "name": "USD_RLS",
  "slug": "usd_rls",
  "labelEn": "US Dollar / Iranian Rial",
  "labelFa": "دلار آمریکا / ریال ایران",
  "quoteUnit": "RLS",
  "value": "<protected-market-value>",
  "businessTime": "<source-timestamp>",
  "buyPrice": "<protected-market-value>",
  "sellPrice": "<protected-market-value>"
}

نمونهٔ جداگانهٔ سمت ناموجود (مقادیر محافظت‌شده):

{
  "buyPrice": "<protected-market-value>",
  "sellPrice": null
}