Документация API
Агрегация данных с нескольких бирж и расширенная фильтрация
Управляйте агрегацией данных на Bybit, Binance и Hyperliquid с расширенной фильтрацией, сортировкой и нормализацией. Получайте единую аналитику рынка с 3+ бирж одновременно.
Опубликовано 21 марта 2026
•
17 мин чтения
•
Продвинутый
Обзор агрегации данных
Smart Money API агрегирует данные по криптовалютным деривативам с 3 крупных бирж: Bybit, Binance и Hyperliquid. Вместо отдельных API-запросов к каждой бирже вы получаете унифицированные данные с интеллектуальной фильтрацией, кросс-биржевым сравнением и расширенными аналитическими возможностями.
Почему агрегация важна:
- Один 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 |
Perpetual |
| binance |
800+ |
1-125x |
1s |
Perpetual |
| hyperliquid |
300+ |
1-20x |
5s |
Perpetual |
Получите 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 открывают расширенную фильтрацию и исторические запросы.