Dokumentacja API
Agregacja danych z wielu giełd i zaawansowane filtrowanie
Zarządzaj agregacją danych z Bybit, Binance i Hyperliquid z zaawansowanym filtrowaniem, sortowaniem i normalizacją. Otrzymuj ujednolicone dane rynkowe z 3+ giełd jednocześnie.
Opublikowano 21 marca 2026
•
17 min czytania
•
Zaawansowane
Przegląd agregacji danych
Smart Money API agreguje dane instrumentów pochodnych kryptowalut z 3 głównych giełd: Bybit, Binance i Hyperliquid. Zamiast wykonywać osobne wywołania API do każdej giełdy, otrzymujesz ujednolicone dane z inteligentnym filtrowaniem, porównaniem między giełdami i zaawansowanymi możliwościami analitycznymi.
Dlaczego agregacja ma znaczenie:
- Pojedyncze wywołanie API — Pobierz dane z 3 giełd jednocześnie bez zarządzania wieloma połączeniami
- Znormalizowany format — Wszystkie giełdy standaryzowane do spójnego schematu
- Analiza międzygiełdowa — Porównuj stopy fundingowe, pozycje i płynność na różnych platformach
- Inteligentne filtrowanie — Wyszukuj dokładnie te dane, których potrzebujesz, za pomocą zaawansowanych filtrów
- Wydajność — Odpowiedzi agregowane i buforowane w CDN są 50x szybsze niż samodzielna agregacja
Architektura: Smart Money API zbiera dane z giełd co 1-5 sekund, normalizuje je, buforuje na krawędzi CDN i dostarcza agregowane odpowiedzi z opóźnieniem poniżej 100 ms na całym świecie.
Obsługiwane giełdy
Bybit
Kod: bybit | Zasięg: 500+ par perpetual | Częstotliwość aktualizacji: 1 sekunda
- Futures perpetual USDT (kontrakty liniowe)
- Futures perpetual odwrotne (XRP, ETC)
- Pełne dane order book i transakcji
- Stopy fundingowe i ceny markowe
Binance
Kod: binance | Zasięg: 800+ par perpetual | Częstotliwość aktualizacji: 1 sekunda
- Futures USDT-M (perpetual USDT)
- Futures COIN-M (odwrotne)
- Pełne dane mikrostruktury rynku
- Najwyższa płynność wśród par
Hyperliquid
Kod: hyperliquid | Zasięg: 300+ par perpetual | Częstotliwość aktualizacji: 5 sekund
- Zdecentralizowane futures perpetual (bez marży)
- Unikalny model rozliczeń on-chain
- Integracja danych portfeli wielorybów
- Mniejsze opóźnienia dla traderów algorytmicznych
Tabela specyfikacji giełd
| Giełda |
Pary |
Dźwignia |
Częstotliwość akt. |
Rozliczenie |
| bybit |
500+ |
1-125x |
1s |
Perpetual |
| binance |
800+ |
1-125x |
1s |
Perpetual |
| hyperliquid |
300+ |
1-20x |
5s |
Perpetual |
Uzyskaj klucz API w 30 sekund
Gotowy do budowania? Pobierz darmowy klucz API (200 wywołań/dzień, bez karty) i zacznij pobierać dane o wielorybach, fundingach i danych on-chain.
Uzyskaj klucz API →Koncepcje łączenia danych
Normalizacja
Każda giełda ma różne nazwy pól, precyzję dziesiętną i struktury danych. Smart Money normalizuje wszystko do standardowego schematu:
{
"exchange": "bybit",
"symbol": "BTCUSDT",
"funding_rate": 0.0001,
"mark_price": 72500.50,
"index_price": 72480.25,
"open_interest": 850000000,
"timestamp": 1709980800000
}
Wyrównanie znaczników czasu
Wszystkie punkty danych są oznaczone znacznikiem czasu i wyrównane do UTC w milisekundach. Starsze dane są obsługiwane przejrzyście:
- Dane w czasie rzeczywistym: pobrane w ciągu ostatnich 5 sekund
- Dane starsze: oznaczone age_ms wskazującym na przestarzałość
- Brakujące giełdy: zwraca częściowe wyniki z listą giełd
- Pełne przestarzałe dane: zwraca wynik z bufora z cache_age_seconds
Metadane międzygiełdowe
Każda agregowana odpowiedź zawiera metadane o źródłach danych:
{
"data": [...],
"_meta": {
"exchanges": ["bybit", "binance", "hyperliquid"],
"count": 245,
"aggregated_at": 1709980800123,
"sources_healthy": true
}
}
Podstawowe Filtrowanie
Filtruj według Giełdy
Pobierz dane tylko z określonych giełd:
// Pobierz stopy finansowania tylko z Binance
GET /v1/derivatives/funding-heatmap?exchange=binance
// Wiele giełd
GET /v1/derivatives/funding-heatmap?exchange=bybit,binance
Filtruj według Klasy Aktywów
Filtruj według kryptowaluty lub pary handlowej:
// Tylko pary Bitcoin
GET /v1/derivatives/funding-heatmap?asset=BTC
// Wiele aktywów
GET /v1/derivatives/funding-heatmap?asset=BTC,ETH,SOL
// Określone pary
GET /v1/derivatives/funding-heatmap?symbol=BTCUSDT,ETHUSDT
Filtruj według Zakresu Metryki
Zapytanie oparte na wartościach liczbowych:
// Wysokie stopy finansowania (>0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_min=0.0001
// Niskie stopy finansowania (<-0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_max=-0.0001
// Wysokie otwarte zainteresowanie
GET /v1/derivatives/oi-rankings?oi_min=100000000
Zaawansowane Filtrowanie
Filtry Porównawcze
Znajdź pary o określonych cechach na różnych giełdach:
// Pary z różnicą stóp finansowania >5% między giełdami
GET /v1/derivatives/comparative?metric=funding_rate_spread&min=0.0005
// Rozbieżność likwidacji
GET /v1/derivatives/comparative?metric=liquidation_pressure_diff
// Pary z najwyższym stosunkiem otwartego zainteresowania Bybit/Binance
GET /v1/derivatives/comparative?metric=oi_ratio&base=bybit&compare=binance&min=1.5
Filtry Czasowe
Zapytanie o zagregowane dane historyczne:
// Dane z określonego przedziału czasowego
GET /v1/derivatives/funding-heatmap?start_time=1709980800&end_time=1709984400
// Ostatnie 24 godziny
GET /v1/derivatives/funding-heatmap?lookback=24h
// Migawki w odstępach 1-godzinnych
GET /v1/derivatives/historical?interval=1h&limit=24
Filtry Złożone
Połącz wiele warunków filtrowania:
// Pary najwyższej klasy: BTC, ETH, SOL
// Wysokie dodatnie finansowanie na Binance
// Ujemne finansowanie na Bybit (arbitraż)
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
Sortowanie i Ranking
Kierunki Sortowania
Kontroluj kolejność wyników:
// Najwyższe stopy finansowania pierwsze
GET /v1/derivatives/funding-heatmap?sort=funding_rate:desc
// Najniższe otwarte zainteresowanie
GET /v1/derivatives/oi-rankings?sort=open_interest:asc
// Najnowszy znacznik czasu
GET /v1/derivatives/funding-heatmap?sort=timestamp:desc
// Sortowanie wielopolowe
GET /v1/derivatives?sort=exchange:asc,funding_rate:desc
Opcje Rankingu
| Pole |
Opis |
Zakres |
| funding_rate |
Stopa finansowania kontraktu perpetual |
-1.0 do 1.0 |
| open_interest |
Całkowite otwarte pozycje w USD |
0 do miliardów |
| mark_price |
Cena mark/settlement kontraktu |
Dodatnia |
| liquidation_pressure |
Ryzyko likwidacji długich vs krótkich |
-1.0 do 1.0 |
Tryby Agregacji Danych
Agregacja Surowa
Zwróć wszystkie punkty danych oddzielnie z identyfikacją źródła giełdy:
GET /v1/derivatives/funding-heatmap?aggregate_mode=raw&symbol=BTCUSDT
// Odpowiedź: 3 oddzielne wpisy (jeden na giełdę)
[
{ exchange: "bybit", funding_rate: 0.00010 },
{ exchange: "binance", funding_rate: 0.00012 },
{ exchange: "hyperliquid", funding_rate: 0.00009 }
]
Agregacja Scalona
Połącz dane w jeden rekord z polami statystycznymi:
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 }
}
Agregacja Złożona
Agregacja statystyczna z wynikami zaufania:
GET /v1/derivatives/funding-heatmap?aggregate_mode=composite&symbol=BTCUSDT
{
symbol: "BTCUSDT",
funding_rate_consensus: 0.000103,
confidence_score: 0.98, // 98% zgodności
outliers: [],
weighted_avg: 0.000102, // ważone płynnością
exchange_details: { ... }
}
Normalizacja Danych
Normalizacja Cen
Wszystkie ceny są znormalizowane do 8 miejsc po przecinku i denominacji USDT:
- Bybit: pary USDT znormalizowane bezpośrednio
- Binance: USDT-M i COIN-M przeliczone na standardową formę
- Hyperliquid: Natywny USDT konwertowany spójnie
Normalizacja wolumenu
Wszystkie wolumeny podawane w jednostkach aktywa bazowego:
{
"volume_base": 1234.5,
"volume_quote": 89234500,
"num_trades": 45678
}
Normalizacja znacznika czasu
- Wszystkie znaczniki czasu w milisekundach UTC (13 cyfr)
- Zsynchronizowane z zegarem bramki API
- Korekta wieku dla danych zebranych w różnych czasach
- Niezależne od strefy czasowej (zawsze UTC)
Praktyczne przykłady zapytań
Przykład 1: Możliwości arbitrażu stóp fundingowych
Znajdź pary z największym spreadem między długim fundingiem na Binance a krótkim fundingiem na Bybit:
GET /v1/derivatives/funding-heatmap?
exchange=bybit,binance&
asset=BTC,ETH,SOL,ARB&
sort=funding_rate_spread:desc&
limit=10&
aggregate_mode=merged
Przykład 2: Kontrakty z wysokim otwartym zainteresowaniem
Pobierz kontrakty ze znacznym otwartym zainteresowaniem na wszystkich giełdach:
GET /v1/derivatives/oi-rankings?
oi_min=100000000&
sort=open_interest:desc&
limit=20&
aggregate_mode=merged
Przykład 3: Agregacja szeregów czasowych
Historyczne stopy fundingowe w 4-godzinnych odstępach:
GET /v1/historical/funding?
symbol=BTCUSDT&
interval=4h&
limit=30&
aggregate_mode=composite
Mistrz danych wielogiełdowych
Otrzymuj ujednolicone dane instrumentów pochodnych z Bybit, Binance i Hyperliquid z potężnym filtrowaniem, agregacją i normalizacją. Oszczędzaj czas inżynierów i redukuj koszty API.
Zobacz plany
Darmowy poziom obejmuje podstawową agregację. Plany Trader i Pro odblokowują zaawansowane filtrowanie i zapytania historyczne.