Obsah

Přehled Podporované burzy Koncepty fúze dat Základní filtrování Pokročilé filtry Řazení a hodnocení Agregace dat Normalizace dat Příklady dotazů Tipy pro výkon

Dokumentace API

Multi-Exchange Data Aggregation and Advanced Filtering

Zvládněte agregaci dat napříč burzami Bybit, Binance a Hyperliquid s pokročilým filtrováním, řazením a normalizací. Získejte jednotné přehledy trhu z více než 3 burz současně.

Publikováno 21. března 2026 • 17 minut čtení • Pokročilé

Přehled agregace dat

Smart Money API agreguje data o kryptoměnových derivátech ze 3 hlavních burz: Bybit, Binance a Hyperliquid. Místo provádění samostatných API volání na každou burzu získáte jednotná data s inteligentním filtrováním, porovnáním napříč burzami a pokročilými analytickými schopnostmi.

Proč je agregace důležitá:

Jedno API volání — Získejte data ze 3 burz současně bez nutnosti spravovat více připojení
Normalizovaný formát — Všechny burzy jsou standardizovány na konzistentní schéma
Přehledy napříč burzami — Porovnejte sazby financování, pozice a likviditu napříč platformami
Inteligentní filtrování — Dotazujte přesně ta data, která potřebujete, pomocí výkonných filtrů
Výkon — Agregované odpovědi uložené v CDN jsou 50x rychlejší než vlastní agregace

Architektura: Smart Money API sbírá data z burz každých 1-5 sekund, normalizuje je, ukládá do mezipaměti na CDN edge a poskytuje agregované odpovědi s latencí pod 100 ms globálně.

Podporované burzy

Bybit

Kód: bybit | Pokrytí: 500+ párových kontraktů | Frekvence aktualizace: 1 sekunda

USDT perpetual futures (lineární kontrakty)
Inverzní perpetualy (XRP, ETC)
Kompletní data o knize objednávek a obchodech
Sazby financování a mark prices

Binance

Kód: binance | Pokrytí: 800+ párových kontraktů | Frekvence aktualizace: 1 sekunda

USDT-M (USDT perpetual) futures
COIN-M (inverzní) futures
Kompletní mikrostruktura trhu
Nejvyšší likvidita napříč páry

Hyperliquid

Kód: hyperliquid | Pokrytí: 300+ párových kontraktů | Frekvence aktualizace: 5 sekund

Decentralizované perpetual futures (bez marže)
Unikátní on-chain model vypořádání
Integrace nativních dat velrybích peněženek
Nižší latence pro algoritmické obchodníky

Tabulka specifikací burz

Burza	Páry	Páka	Frekvence aktualizace	Vypořádání
bybit	500+	1-125x	1s	Perpetual
binance	800+	1-125x	1s	Perpetual
hyperliquid	300+	1-20x	5s	Perpetual

Získejte svůj API klíč za 30 sekund

Připraveni stavět? Získejte bezplatný API klíč (200 volání/den, bez karty) a začněte stahovat živá data o velrybách, financování a on-chain datech.

Získejte svůj API klíč →

Koncepty fúze dat

Normalizace

Každá burza má různé názvy polí, desetinnou přesnost a datové struktury. Smart Money vše normalizuje na standardní schéma:

Normalizovaná odpověď
{
 "exchange": "bybit",
 "symbol": "BTCUSDT",
 "funding_rate": 0.0001,
 "mark_price": 72500.50,
 "index_price": 72480.25,
 "open_interest": 850000000,
 "timestamp": 1709980800000
}

Synchronizace časových razítek

Všechny datové body jsou časově označeny a synchronizovány na UTC milisekundy. Starší data jsou zpracována transparentně:

Reálná data: získaná v posledních 5 sekundách
Stárnoucí data: označena věkem_ms indikujícím zastaralost
Chybějící burzy: vrací částečné výsledky se seznamem burz
Úplně zastaralá data: vrací výsledek z mezipaměti s cache_age_seconds

Metadata napříč burzami

Každá agregovaná odpověď obsahuje metadata o zdrojích dat:

Metadata agregace
{
 "data": [...],
 "_meta": {
 "exchanges": ["bybit", "binance", "hyperliquid"],
 "count": 245,
 "aggregated_at": 1709980800123,
 "sources_healthy": true
  }
}

Základní filtrování

Filtrovat podle burzy

Požadovat data pouze od konkrétních burz:

Filtr jedné burzy
// Získat funding rates pouze z Binance
GET /v1/derivatives/funding-heatmap?exchange=binance
// Více burz
GET /v1/derivatives/funding-heatmap?exchange=bybit,binance

Filtrovat podle třídy aktiv

Filtrovat podle kryptoměny nebo obchodního páru:

Filtr aktiv
// Pouze páry s Bitcoinem
GET /v1/derivatives/funding-heatmap?asset=BTC
// Více aktiv
GET /v1/derivatives/funding-heatmap?asset=BTC,ETH,SOL
// Konkrétní páry
GET /v1/derivatives/funding-heatmap?symbol=BTCUSDT,ETHUSDT

Filtrovat podle rozsahu metriky

Dotaz založený na číselných hodnotách:

Filtry rozsahu
// Vysoké funding rates (>0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_min=0.0001
// Nízké funding rates (<-0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_max=-0.0001
// Vysoký open interest
GET /v1/derivatives/oi-rankings?oi_min=100000000

Pokročilé filtrování

Komparativní filtry

Najít páry se specifickými charakteristikami napříč burzami:

Komparativní dotazy
// Páry s rozdílem funding rate >5% napříč burzami
GET /v1/derivatives/comparative?metric=funding_rate_spread&min=0.0005
// Divergence likvidací
GET /v1/derivatives/comparative?metric=liquidation_pressure_diff
// Páry s nejvyšším poměrem open interest Bybit/Binance
GET /v1/derivatives/comparative?metric=oi_ratio&base=bybit&compare=binance&min=1.5

Časové filtry

Dotazovat agregovaná historická data:

Časové filtry
// Data z konkrétního časového okna
GET /v1/derivatives/funding-heatmap?start_time=1709980800&end_time=1709984400
// Posledních 24 hodin
GET /v1/derivatives/funding-heatmap?lookback=24h
// Snapshoty v 1hodinových intervalech
GET /v1/derivatives/historical?interval=1h&limit=24

Kombinované filtry

Kombinovat více podmínek filtrování:

Komplexní dotaz
// Top páry: BTC, ETH, SOL
// Vysoký pozitivní funding na Binance
// Negativní funding na Bybit (arbitráž)
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

Řazení a hodnocení

Směry řazení

Ovládat pořadí výsledků:

Příklady řazení
// Nejvyšší funding rates první
GET /v1/derivatives/funding-heatmap?sort=funding_rate:desc
// Nejnižší open interest
GET /v1/derivatives/oi-rankings?sort=open_interest:asc
// Nejnovější timestamp
GET /v1/derivatives/funding-heatmap?sort=timestamp:desc
// Vícepolové řazení
GET /v1/derivatives?sort=exchange:asc,funding_rate:desc

Možnosti hodnocení

Pole	Popis	Rozsah
funding_rate	Funding rate perpetálních kontraktů	-1.0 až 1.0
open_interest	Celkové otevřené pozice v USD	0 až miliardy
mark_price	Mark/settlement cena kontraktu	Kladné
liquidation_pressure	Riziko likvidace longů vs. shortů	-1.0 až 1.0

Módy agregace dat

Nezpracovaná agregace

Vrátit všechny datové body samostatně s identifikací zdrojové burzy:

Nezpracovaný mód
GET /v1/derivatives/funding-heatmap?aggregate_mode=raw&symbol=BTCUSDT
// Odpověď: 3 samostatné záznamy (jeden za burzu)
[
  { exchange: "bybit", funding_rate: 0.00010 },
  { exchange: "binance", funding_rate: 0.00012 },
  { exchange: "hyperliquid", funding_rate: 0.00009 }
]

Sloučená agregace

Kombinovat data do jednoho záznamu se statistickými poli:

Sloučený mód
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 }
}

Kompozitní agregace

Statistická agregace s mírou spolehlivosti:

Kompozitní mód
GET /v1/derivatives/funding-heatmap?aggregate_mode=composite&symbol=BTCUSDT
{
  symbol: "BTCUSDT",
  funding_rate_consensus: 0.000103,
  confidence_score: 0.98,  // 98% shoda
  outliers: [],
  weighted_avg: 0.000102,  // vážené likviditou
  exchange_details: { ... }
}

Normalizace dat

Normalizace cen

Všechny ceny jsou normalizovány na 8 desetinných míst a denominaci USDT:

Bybit: USDT páry normalizovány přímo
Binance: USDT-M a COIN-M převedeny do standardní formy
Hyperliquid: Nativní USDT konzistentně převedeno

Normalizace objemu

Všechny objemy jsou uváděny v jednotkách základního aktiva:

Pole objemu
{
 "volume_base": 1234.5,  // BTC
 "volume_quote": 89234500,  // USDT
 "num_trades": 45678
}

Normalizace časových razítek

Všechna časová razítka v UTC milisekundách (13 číslic)
Synchronizováno s hodinami API gateway
Úprava stáří pro data shromážděná v různých časech
Nezávislé na časovém pásmu (vždy UTC)

Praktické příklady dotazů

Příklad 1: Arbitrážní příležitosti u funding rate

Najděte páry s největším rozdílem mezi dlouhým fundingem na Binance a krátkým fundingem na Bybit:

Arbitrážní dotaz
GET /v1/derivatives/funding-heatmap?
  exchange=bybit,binance&
  asset=BTC,ETH,SOL,ARB&
  sort=funding_rate_spread:desc&
  limit=10&
  aggregate_mode=merged

Příklad 2: Kontrakty s vysokým open interest

Získejte kontrakty s významným open interest napříč všemi burzami:

Dotaz na likviditu
GET /v1/derivatives/oi-rankings?
  oi_min=100000000&
  sort=open_interest:desc&
  limit=20&
  aggregate_mode=merged

Příklad 3: Agregace časových řad

Historické funding rates v 4hodinových intervalech:

Historická agregace
GET /v1/historical/funding?
  symbol=BTCUSDT&
  interval=4h&
  limit=30&
  aggregate_mode=composite

Tipy na výkon

1. Používejte specifické filtry

Čím konkrétnější je váš dotaz, tím rychlejší bude odpověď. Filtrování 800 párů na 5 vrátí výsledky rychleji než žádost o všechny.

2. Omezte výslednou sadu

Vždy specifikujte parametr limit. Výchozí hodnota je 100; maximum je 1000. Velké výsledné sady jsou pomalejší a spotřebovávají více šířky pásma.

3. Zvolte režim agregace

Merged a composite režimy jsou pro malé datové sady rychlejší než raw režim. Raw režim je lepší pro detailní analýzu jednotlivých burz.

4. Agresivně využívejte cache

Tyto odpovědi mají předvídatelnou dobu životnosti cache. Implementujte lokální ukládání do cache, abyste se vyhnuli redundantním požadavkům.

5. Používejte specifické časové rozsahy

Historické dotazy s úzkými časovými okny jsou mnohem rychlejší než parametry s otevřeným lookbackem.

Ovládněte data z více burz

Získejte sjednocená data o derivátech z Bybit, Binance a Hyperliquid s výkonným filtrováním, agregací a normalizací. Ušetřete čas vývojářů a snižte náklady na API.

Zobrazit plány

Bezplatná úroveň zahrnuje základní agregaci. Obchodní a Pro plány odemykají pokročilé filtrování a historické dotazy.