Документація API
Агрегація даних з кількох бірж та розширена фільтрація
Об’єднуйте дані з Bybit, Binance та Hyperliquid за допомогою розширеної фільтрації, сортування та нормалізації. Отримуйте уніфіковані ринкові дані з 3+ бірж одночасно.
Опубліковано 21 березня 2026
•
17 хв читання
•
Розширений
Огляд агрегації даних
Smart Money API агрегує дані про криптовалютні деривативи з 3 основних бірж: Bybit, Binance та Hyperliquid. Замість окремих запитів до кожної біржі ви отримуєте об’єднані дані з розумною фільтрацією, порівнянням між біржами та розширеними аналітичними можливостями.
Чому агрегація важлива:
- Один запит до API — Отримуйте дані з 3 бірж одночасно без керування кількома підключеннями
- Уніфікований формат — Усі біржі стандартизовані до єдиної схеми
- Аналітика між біржами — Порівнюйте ставки фандингу, позиції та ліквідність на різних майданчиках
- Розумна фільтрація — Отримуйте саме ті дані, які вам потрібні, за допомогою потужних фільтрів
- Продуктивність — Кешовані CDN-відповіді працюють у 50 разів швидше, ніж самостійна агрегація
Архітектура: Smart Money API збирає дані з бірж кожні 1-5 секунд, нормалізує їх, кешує на CDN-мережі та надає агреговані відповіді з затримкою менше 100 мс у всьому світі.
Підтримувані біржі
Bybit
Код: bybit | Охоплення: 500+ перпетуальних пар | Частота оновлення: 1 секунда
- USDT-перпетуальні ф’ючерси (лінійні контракти)
- Інверсні перпетуальні (XRP, ETC)
- Повні дані про стакан та угоди
- Ставки фандингу та маркові ціни
Binance
Код: binance | Охоплення: 800+ перпетуальних пар | Частота оновлення: 1 секунда
- USDT-M (USDT перпетуальні) ф’ючерси
- COIN-M (інверсні) ф’ючерси
- Повні дані про ринкову мікроструктуру
- Найвища ліквідність серед пар
Hyperliquid
Код: hyperliquid | Охоплення: 300+ перпетуальних пар | Частота оновлення: 5 секунд
- Децентралізовані перпетуальні ф’ючерси (без маржи)
- Унікальна модель розрахунків на ланцюгу
- Інтеграція даних гаманців китів
- Менша затримка для алгоритмічних трейдерів
Таблиця специфікацій бірж
| Біржа |
Пари |
Кредитне плече |
Частота оновлення |
Розрахунки |
| bybit |
500+ |
1-125x |
1s |
Перпетуальні |
| binance |
800+ |
1-125x |
1s |
Перпетуальні |
| hyperliquid |
300+ |
1-20x |
5s |
Перпетуальні |
Отримайте API-ключ за 30 секунд
Готові до розробки? Отримайте безкоштовний API-ключ (100 запитів/день, без картки) та почніть отримувати дані про китів, фандинг та ончейн-дані.
Отримайте API-ключ →Концепції об’єднання даних
Нормалізація
Кожна біржа має різні назви полів, точність десяткових знаків та структури даних. Smart Money нормалізує все до стандартної схеми:
{
"exchange": "bybit",
"symbol": "BTCUSDT",
"funding_rate": 0.0001,
"mark_price": 72500.50,
"index_price": 72480.25,
"open_interest": 850000000,
"timestamp": 1709980800000
}
Синхронізація часових міток
Усі дані мають часові мітки та синхронізовані до UTC з точністю до мілісекунд. Обробка застарілих даних відбувається прозоро:
- Дані в реальному часі: отримані за останні 5 секунд
- Застарілі дані: позначені age_ms, що вказує на застарілість
- Відсутні біржі: повертаються часткові результати зі списком бірж
- Повністю застарілі дані: повертається кешований результат з cache_age_seconds
Метадані між біржами
Кожна агрегована відповідь містить метадані про джерела даних:
{
"data": [...],
"_meta": {
"exchanges": ["bybit", "binance", "hyperliquid"],
"count": 245,
"aggregated_at": 1709980800123,
"sources_healthy": true
}
}
Базове фільтрування
Фільтр за біржами
Запитуйте дані лише з певних бірж:
// Отримайте ставки фінансування лише з Binance
GET /v1/derivatives/funding-heatmap?exchange=binance
// Кілька бірж
GET /v1/derivatives/funding-heatmap?exchange=bybit,binance
Фільтр за класом активів
Фільтруйте за криптовалютою або торговою парою:
// Лише пари з Bitcoin
GET /v1/derivatives/funding-heatmap?asset=BTC
// Кілька активів
GET /v1/derivatives/funding-heatmap?asset=BTC,ETH,SOL
// Конкретні пари
GET /v1/derivatives/funding-heatmap?symbol=BTCUSDT,ETHUSDT
Фільтр за діапазоном метрик
Запити на основі числових значень:
// Високі ставки фінансування (>0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_min=0.0001
// Низькі ставки фінансування (<-0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_max=-0.0001
// Високий відкритий інтерес
GET /v1/derivatives/oi-rankings?oi_min=100000000
Розширене фільтрування
Порівняльні фільтри
Знайдіть пари з певними характеристиками на різних біржах:
// Пари з різницею ставок фінансування >5% на різних біржах
GET /v1/derivatives/comparative?metric=funding_rate_spread&min=0.0005
// Розбіжність ліквідацій
GET /v1/derivatives/comparative?metric=liquidation_pressure_diff
// Пари з найвищим співвідношенням відкритого інтересу Bybit/Binance
GET /v1/derivatives/comparative?metric=oi_ratio&base=bybit&compare=binance&min=1.5
Фільтри за часом
Запитуйте історичні агреговані дані:
// Дані з певного часового вікна
GET /v1/derivatives/funding-heatmap?start_time=1709980800&end_time=1709984400
// Останні 24 години
GET /v1/derivatives/funding-heatmap?lookback=24h
// Знімки з інтервалом 1 година
GET /v1/derivatives/historical?interval=1h&limit=24
Композитні фільтри
Поєднуйте кілька умов фільтрації:
// Топові пари: BTC, ETH, SOL
// Високе позитивне фінансування на Binance
// Негативне фінансування на Bybit (арбітраж)
GET /v1/derivatives/funding-heatmap?
asset=BTC,ETH,SOL&
exchange=binance,bybit&
binance_funding_rate_min=0.0003&
bybit_funding_rate_max=-0.0001&
sort=funding_rate_spread:desc
Сортування та ранжування
Напрямки сортування
Керуйте порядком результатів:
// Спочатку найвищі ставки фінансування
GET /v1/derivatives/funding-heatmap?sort=funding_rate:desc
// Найнижчий відкритий інтерес
GET /v1/derivatives/oi-rankings?sort=open_interest:asc
// Найновіший часовий штамп
GET /v1/derivatives/funding-heatmap?sort=timestamp:desc
// Багатопольове сортування
GET /v1/derivatives?sort=exchange:asc,funding_rate:desc
Опції ранжування
| Поле |
Опис |
Діапазон |
| funding_rate |
Ставка фінансування перпетуального контракту |
-1.0 до 1.0 |
| open_interest |
Загальний відкритий інтерес у USD |
0 до мільярдів |
| mark_price |
Маркова/розрахункова ціна контракту |
Позитивна |
| liquidation_pressure |
Ризик ліквідації лонгів проти шортів |
-1.0 до 1.0 |
Режими агрегації даних
Сирий режим агрегації
Повертає всі точки даних окремо з ідентифікацією джерела біржі:
GET /v1/derivatives/funding-heatmap?aggregate_mode=raw&symbol=BTCUSDT
// Відповідь: 3 окремі записи (по одній на біржу)
[
{ exchange: "bybit", funding_rate: 0.00010 },
{ exchange: "binance", funding_rate: 0.00012 },
{ exchange: "hyperliquid", funding_rate: 0.00009 }
]
Об'єднаний режим агрегації
Об'єднує дані в один запис із статистичними полями:
GET /v1/derivatives/funding-heatmap?aggregate_mode=merged&symbol=BTCUSDT
{
symbol: "BTCUSDT",
funding_rate_avg: 0.000103,
funding_rate_median: 0.00010,
funding_rate_min: 0.00009,
funding_rate_max: 0.00012,
funding_rate_spread: 0.00003,
sources: { bybit, binance, hyperliquid }
}
Композитний режим агрегації
Статистична агрегація з оцінками довіри:
GET /v1/derivatives/funding-heatmap?aggregate_mode=composite&symbol=BTCUSDT
{
symbol: "BTCUSDT",
funding_rate_consensus: 0.000103,
confidence_score: 0.98, // 98% згоди
outliers: [],
weighted_avg: 0.000102, // зважена за ліквідністю
exchange_details: { ... }
}
Нормалізація даних
Нормалізація цін
Усі ціни нормалізовані до 8 знаків після коми та деномінації в USDT:
- Bybit: Пари USDT нормалізовані безпосередньо
- Binance: USDT-M та COIN-M обидва конвертовані до стандартної форми
- Hyperliquid: Нативний USDT конвертується послідовно
Нормалізація обсягів
Усі обсяги вказані в одиницях базового активу:
{
"volume_base": 1234.5,
"volume_quote": 89234500,
"num_trades": 45678
}
Нормалізація часових міток
- Усі часові мітки у мілісекундах UTC (13 цифр)
- Синхронізовано з годинником API шлюзу
- Коригування віку для даних, зібраних у різний час
- Не залежить від часового поясу (завжди UTC)
Практичні приклади запитів
Приклад 1: Арбітражні можливості фандингових ставок
Знайдіть пари з найбільшим розривом між довгим фандингом Binance та коротким фандингом Bybit:
GET /v1/derivatives/funding-heatmap?
exchange=bybit,binance&
asset=BTC,ETH,SOL,ARB&
sort=funding_rate_spread:desc&
limit=10&
aggregate_mode=merged
Приклад 2: Контракти з високим відкритим інтересом
Отримайте контракти зі значним відкритим інтересом на всіх біржах:
GET /v1/derivatives/oi-rankings?
oi_min=100000000&
sort=open_interest:desc&
limit=20&
aggregate_mode=merged
Приклад 3: Агрегація часових рядів
Історичні фандингові ставки з інтервалом 4 години:
GET /v1/historical/funding?
symbol=BTCUSDT&
interval=4h&
limit=30&
aggregate_mode=composite
Опануйте дані з кількох бірж
Отримуйте обʼєднані дані похідних інструментів з Bybit, Binance та Hyperliquid з потужною фільтрацією, агрегацією та нормалізацією. Зекономте час інженерів та зменшіть витрати на API.
Переглянути плани
Безкоштовний рівень включає базову агрегацію. Плани Trader та Pro розблокують розширену фільтрацію та історичні запити.