API شاخص EMpulse Street FX Index
نرخ‌های روزانه بازار آزاد ارزهای بازارهای نوظهور، بر حسب فیات به ازای هر 1 USDT (USDT معادل 1 USD در نظر گرفته می‌شود): نرخی که مردم واقعاً می‌پردازند، نه نرخ رسمی. هر سری یک رده اطمینان دارد. روش کامل در روش‌شناسی آمده است.
فیلدهای هر ردیف شاخص
| فیلد | معنا | چه زمانی null است | طرح |
|---|---|---|---|
buy | میانگین وزنی نرخ روز که مشتری با آن USDT را در ازای فیات می‌خرد. | سمت خرید در آن روز نقطه داده کافی ندارد. | همه طرح‌ها |
sell | همان نرخ برای سمتی که مشتری USDT را می‌فروشد. | سمت فروش در آن روز نقطه داده کافی ندارد. | همه طرح‌ها |
mid | (buy + sell) / 2 وقتی هر دو سمت وجود دارند؛ وقتی فقط یک سمت وجود دارد، نرخ همان سمت. | هیچ‌یک از دو سمت نقطه داده کافی ندارد. | همه طرح‌ها |
side | سمت‌هایی که mid از آن‌ها ساخته شده است: both، buy یا sell. mid ساخته‌شده از یک سمت نسبت به mid دوسمتی تقریباً به اندازه نصف اسپرد جابه‌جا است. | mid وجود ندارد. | همه طرح‌ها |
spread_pct | (buy − sell) / mid × 100. | سمت برابر both نیست. | همه طرح‌ها |
confidence | high، medium یا limited: رده ارز بر اساس پوشش آن؛ روزی که نقطه داده کمتر از معمول دارد یک رده پایین‌تر قرار می‌گیرد. limited یعنی منابع یا نقاط داده کمتر، نوسان تصادفی بیشتر و احتمال وجود وقفه. | هرگز. | همه طرح‌ها |
flag | outlier برای روزی با نقاط داده اندک که mid آن بیش از 10% از میانه mid در ±15 روز اطرافش فاصله دارد. چنین روزی مقادیرش را حفظ می‌کند، اما از mid_7d و فیلدهای chg_* کنار گذاشته می‌شود. | روز پرت نیست. | همه طرح‌ها |
in_progress | true برای آخرین روز یک ارز، تا زمانی که روز هنوز در حال جمع‌آوری است و نقاط داده آن به‌وضوح کمتر از معمول 7 روز قبل است. | هرگز. | همه طرح‌ها |
mid_7d | میانگین midهای معتبر در 7 روز تقویمی گذشته، با احتساب روز جاری. | در این بازه هیچ mid معتبری وجود ندارد. | همه طرح‌ها |
chg_1d_pct | تغییر mid نسبت به دقیقاً 1 روز تقویمی قبل، بر حسب درصد. | یکی از دو روز mid معتبر ندارد. | همه طرح‌ها |
chg_7d_pct | تغییر mid نسبت به دقیقاً 7 روز تقویمی قبل، بر حسب درصد. | یکی از دو روز mid معتبر ندارد. | همه طرح‌ها |
chg_30d_pct | تغییر mid نسبت به دقیقاً 30 روز تقویمی قبل، بر حسب درصد. | یکی از دو روز mid معتبر ندارد. | همه طرح‌ها |
exchange_spread_pct | میزان فاصله صرافی‌هایی که این ارز را در آن روز نرخ‌گذاری می‌کنند: (بالاترین − پایین‌ترین mid صرافی‌ها) / میانه × 100. افزایش این فاصله یکی از ورودی‌های FX Stress Signals است. | کمتر از دو صرافی این ارز را نرخ‌گذاری می‌کنند، یا کلید از نوع رایگان است. | Pro، Enterprise |
تاریخ‌ها روزهای تقویمی UTC هستند. آخرین روز تا پایان یافتن ناقص است و ممکن است اصلاح شود؛ پرچم‌های 15 روز آخر با رسیدن داده‌های جدید ممکن است تغییر کنند.
نرخ‌های ساعتی (Pro و Enterprise). GET /v1/rates/CUR/hourly?from=&to= شاخص را به تفکیک ساعت UTC برمی‌گرداند (حداکثر 31 روز در هر درخواست)، /v1/rates/CUR/hourly/latest آخرین 24 ساعت یک سری را، و /v1/rates/hourly/latest آخرین ساعت کامل هر ارز را. ردیف‌های ساعتی همان فیلدهای buy، sell، mid، side، spread_pct، confidence و in_progress را دارند؛ پاسخ‌های هر ارز برای هر روز یک summary هم اضافه می‌کنند. کلیدهای رایگان خطای 403 با کد tier_not_in_plan دریافت می‌کنند.
شاخص چندمنبعی بازار آزاد. /v1/street-index/*: نرخ‌های بازار آزاد تجمیع‌شده از منابع بازار عمومی مستقل متعدد، همراه با امتیاز اطمینان، برای هر ارزی که منابع پوشش می‌دهند (با همان کلید).
کلید خود را در هدر X-API-Key ارسال کنید. رایگان: فقط RUB, UAH, EGP، 100 درخواست در روز، تا آخرین روز کامل. Pro: همه ارزها، 10,000 درخواست در روز، شامل روز جاری (در حال انجام). Enterprise: طبق قرارداد. محدودیت‌ها ساعت 00:00 UTC بازنشانی می‌شوند.
به‌طور پیش‌فرض JSON؛ برای CSV هدر Accept: text/csv را ارسال کنید یا ?format=csv را اضافه کنید. خطاها به‌صورت JSON و با یک شیء error شامل code و message بازگردانده می‌شوند، با وضعیت 400 (پارامترهای نامعتبر)، 401 (کلید ناموجود یا نامعتبر)، 403 (دوره، ارز یا محصول خارج از طرح: tier_delay، currency_not_in_plan، tier_not_in_plan، key_frozen)، 404 (ارز یا مسیر ناشناخته)، 429 (rate_limit_exceeded، history_quota_exceeded) یا 503.
ردیف‌های قدیمی‌تر از 90 روز از سهمیه روزانه هر کلید کسر می‌شوند (رایگان 1,000، Pro 3,000 ردیف در هر روز UTC)؛ خروجی کامل در چارچوب توافق Enterprise در دسترس است. کلیدها شخصی هستند؛ دانلود انبوه خودکار باعث مسدود شدن کلید می‌شود. شرایط را ببینید.
نرخ‌های بازار آزاد، نرخ رسمی یا بین‌بانکی نیستند؛ سری‌هایی که confidence آن‌ها limited است ممکن است پرنوسان باشند و شکاف داشته باشند. این داده‌ها توصیه سرمایه‌گذاری نیستند.