API EMpulse Street FX Index
Ежедневные уличные курсы валют развивающихся рынков, выраженные в фиате за 1 USDT (USDT приравнивается к 1 USD): курс, по которому люди фактически платят, а не официальный. Каждый ряд имеет класс confidence. Полное описание метода — в методологии.
Поля строки индекса
| Поле | Значение | Когда равно null | Тариф |
|---|---|---|---|
buy | Средневзвешенный за день курс, по которому клиент покупает USDT за фиат. | За день слишком мало данных по стороне покупки. | Все тарифы |
sell | То же для стороны, на которой клиент продаёт USDT. | За день слишком мало данных по стороне продажи. | Все тарифы |
mid | (buy + sell) / 2, если есть обе стороны; если есть только одна сторона — курс этой стороны. | Ни по одной из сторон нет достаточного количества данных. | Все тарифы |
side | Из каких сторон построен mid: both, buy или sell. Mid по одной стороне смещён примерно на половину спреда относительно mid по двум сторонам. | Mid отсутствует. | Все тарифы |
spread_pct | (buy − sell) / mid × 100. | Значение side не равно 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/* — уличные курсы, агрегированные из многих независимых публичных рыночных источников, с оценкой confidence, для каждой валюты, которую покрывают источники (тот же ключ).
Передавайте ключ в заголовке X-API-Key. Free: только 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 дн. учитываются в суточной квоте на ключ (Free — 1,000, Pro — 3,000 строк за сутки UTC); полные выгрузки доступны по соглашению Enterprise. Ключи персональные; автоматическая массовая загрузка приводит к блокировке ключа. См. условия.
Уличные курсы не являются официальными или межбанковскими курсами; ряды с confidence limited могут быть нестабильными и содержать пропуски. Данные не являются инвестиционной рекомендацией.