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 відхиляється від медіани mid за навколишні ±15 днів більш ніж на 10%. Такий день зберігає свої значення, але не враховується в 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 можуть бути нестабільними та мати пропуски. Дані не є інвестиційною порадою.