Use an API key to request the supported-assets catalog instead of guessing symbol codes. Its current response is the source of truth for symbol selection, provider coverage, business time, and freshness warnings.
درخواست کاتالوگ
GET /api/v1/assets/supportedcurl -sS https://servix.cc/api/v1/assets/supported \
-H "X-API-Key: <your-api-key>"این مسیر مانند دیگر endpointهای assets به API Key و دسترسی فعال نیاز دارد و یک درخواست از سهمیه روزانه مصرف می کند.
ساختار سطح کاتالوگ
- updatedAt زمان ساخته شدن پاسخ کاتالوگ است؛
- staleThresholdMinutes آستانه فعلی سرویس برای قدیمی تشخیص دادن داده است؛ این عدد را در کلاینت ثابت نکنید؛
- assets آرایه وضعیت همه کدهای شناخته شده است.
فیلدهای هر نماد
| فیلد | کاربرد |
|---|---|
| code | شناسه ای که در {assetName} endpointهای قیمت قرار می گیرد. |
| labelFa و labelEn | برچسب نمایشی فارسی و انگلیسی. |
| providers | منابعی که پوشش فنی نماد را اعلام کرده اند؛ تضمین دائمی دسترسی نیست. |
| providerSupported | وجود پوشش اعلام شده در تنظیمات تامین کننده. |
| latestValueAvailable | آیا آخرین مقدار قابل نمایش وجود دارد. |
| latestValue | آخرین مقدار در صورت وجود. |
| businessTime | زمان مربوط به خود قیمت. |
| sourceTime و insertTime | زمان منبع و زمان ثبت داخلی برای عیب یابی تاخیر. |
| qualityStatus و qualityMessage | نتیجه کنترل کیفیت و توضیح مرتبط. |
| availabilityStatus | وضعیت دسترس پذیری آخرین مقدار. |
| stale | قدیمی بودن داده نسبت به staleThresholdMinutes. |
گروه های رایج نماد
- ارزهای ریالی مانند USD_RLS، EUR_RLS، AED_RLS و GBP_RLS؛
- طلا و فلزات مانند GOLD_18_RLS، GOLD_24_RLS، GOLD_OUNCE_USD و SILVER_OUNCE_USD؛
- سکه مانند SEKKEH_RLS، NIM_SEKKEH_RLS و ROB_SEKKEH_RLS؛
- شاخص بازار ایران با STOCK_IR؛
- رمزارزهای دلاری مانند BTC_USD، ETH_USD و USDT_USD.
این مثال ها جای کاتالوگ زنده را نمی گیرند. تعداد و وضعیت نمادها می تواند تغییر کند؛ برنامه باید پاسخ endpoint را منبع حقیقت بداند.
الگوی پیشنهادی در محصول
- کاتالوگ را در بک اند دریافت و برای مدت منطقی cache کنید؛
- فقط نمادهای دارای providerSupported و latestValueAvailable را برای انتخاب عادی نمایش دهید؛
- code را شناسه داخلی و labelFa را متن رابط فارسی قرار دهید؛
- وقتی stale درست است، زمان داده و هشدار قابل فهم نمایش دهید؛
- برای دریافت مقدار تازه، از endpointهای قیمت جاری استفاده کنید.
نمای عمومی اخیر ارز، طلا، سکه و رمزارز در صفحه اصلی برای آشنایی با پوشش داده موجود است. برای قرارداد کامل پاسخ، OpenAPI عمومی را ببینید و برای توضیح واحدها و تازگی به روش شناسی مراجعه کنید.
صفحه های عمومی قیمت طلا و سکه
برای مشاهده قرارداد واحد، تصویر آخرین قیمت، زمان تجاری، وضعیت تازگی و مسیر دریافت تاریخچه با API Key، مرکز API قیمت طلا و صفحه قیمت طلای ۱۸ عیار را ببینید. برای داده سکه نیز مرکز API قیمت سکه و صفحه قیمت سکه امامی در دسترس است.
Explore market coverage
For a human-readable overview of maintained currency, gold, coin, and cryptocurrency routes, visit supported Servix markets.
Use an allowlist in Vue
The tested Servix guide for Vue 3 and Pinia narrows this catalog to an application-owned allowlist, preserves each quote unit and businessTime, and rejects unknown or malformed assets before they reach the UI.
Cryptocurrency quote-pair catalog
The authenticated catalog contains 48 cryptocurrency base assets with independent USD and RLS instruments. Use baseCode, category, and quoteUnit to discover and group both quotes for a base asset.
GET /api/v1/assets/supported?category=CRYPTO"eUnit=RLSThe category and quoteUnit filters are optional and combine by intersection. The catalog response is the source of truth for codes; the documentation does not maintain a drifting symbol enum.
Global fiat currencies quoted in US dollars
The authenticated catalog now includes 31 additional FX instruments quoted in USD. Their canonical RateSurf midPrice is US dollars per one unit of the base currency; do not invert it or apply the upstream provider's raw orientation.
Newly added symbols:
EUR_USD, AED_USD, GBP_USD, CAD_USD, CHF_USD, TRY_USD, AUD_USD, JPY_USD, CNY_USD, RUB_USD, AFN_USD, AMD_USD, AZN_USD, BHD_USD, BRL_USD, DKK_USD, GEL_USD, HKD_USD, INR_USD, IQD_USD, KWD_USD, MYR_USD, NOK_USD, NZD_USD, OMR_USD, PKR_USD, QAR_USD, SAR_USD, SEK_USD, SGD_USD, THB_USD
GET /api/v1/assets/supported?category=FX"eUnit=USDUse the response's baseCode and quoteUnit to interpret direction. businessTime remains the market observation time, and numeric values remain available only through API-key-protected endpoints.
Interactive panel workflow: To select assets, confirm quota use, and download Excel or JSON, read the Market Data Explorer overview.
New Syrian pound quoted in Iranian rials
SYP_RLS adds the new Syrian pound with Iranian rial as its quote unit and distinguishes it explicitly from the former Syrian pound. Numeric current and historical values require authentication; public price presentation remains limited to server-rendered image pixels.
New Syrian pound quoted directly in US dollars
SYP_USD represents US dollars per one new Syrian pound. The value is neither inverted nor derived from SYP_RLS. Numeric values, observation times, and quality details require authentication; the public catalog exposes only safe code and label metadata.