Obsah

Přehled OHLCV svíčky Možnosti časového rámce Historické dotazy Intervaly agregace Historie pohybů velryb Historie funding rate Data pro backtesting Příklady použití Doporučené postupy

Dokumentace API

Časové řady a dotazy historické analýzy

Získejte komplexní data časových řad pro backtesting, výzkum a historickou analýzu. Dotazujte OHLCV svíčky, historické funding rates, časové osy pohybů velryb a agregované snímky trhu napříč více časovými rámci.

Publikováno 21. března 2026 • 15 minut čtení • Výzkum

Přehled historických dat

Smart Money API poskytuje 24 měsíců historických dat umožňujících komplexní výzkum, backtesting a časovou analýzu. Všechna historická data jsou normalizována, deduplikována a dostupná na více úrovních agregace.

Dostupná historická data zahrnují:

OHLCV svíčky — Open, High, Low, Close, Volume pro všechny obchodované páry
Pohyby velryb — Historická akumulace/distribuce v denním a hodinovém rozlišení
Funding Rates — Historické snímky funding rate pro všechny perpetual páry
Open Interest — Historická data OI napříč všemi burzami a časovými rámci
Likvidace — Historické kaskády likvidací a tlakové body

Uchování dat: Úplná tick data uchovávána po 90 dní. Agregovaná hodinová/denní data uchovávána po 24 měsíců. Nezpracované archivy jsou k dispozici ke stažení.

OHLCV svíčková data

Open-High-Low-Close-Volume data pro technickou analýzu a tvorbu grafů. Dostupné pro všechny kryptoměnové páry napříč časovými rámci od 1 minuty po 1 měsíc.

Struktura OHLCV dat

OHLCV svíčka
{
 "timestamp": 1709980800000,
 "symbol": "BTCUSDT",
 "timeframe": "1h",
 "open": 71250.50,
 "high": 72500.00,
 "low": 71000.25,
 "close": 72250.75,
 "volume_base": 1234.5,
 "volume_quote": 89234500,
 "trades": 45678
}

Dotaz na OHLCV data

Historický dotaz OHLCV
// Získejte 1hodinové svíčky za posledních 30 dní
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  lookback=30d&
  limit=720

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

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

Získejte svůj API klíč →

Dostupné časové rámce

Možnosti časového rámce

Časový rámec	Trvání	Použití	Maximální lookback
1m	1 minuta	Vysokofrekvenční obchodování, scalping	30 dní
5m	5 minut	Intradenní obchodování, swing trading	90 dní
15m	15 minut	Denní obchodování, detekce signálů	180 dní
1h	1 hodina	Střednědobé obchodování, analýza	365 dní
4h	4 hodiny	Swing trading, analýza trendů	24 měsíců
1d	1 den	Dlouhodobé pozicování, výzkum	24 měsíců
1w	1 týden	Makro analýza, víceleté trendy	24 měsíců
1M	1 měsíc	Strategické pozicování	24 měsíců

Kombinace časových rámců

Dotazujte více časových rámců současně:

Dotaz na více časových rámců
GET /v1/historical/ohlcv/multi?
  symbol=BTCUSDT&
  timeframes=1h,4h,1d&
  timestamp=1709980800000
// Vrátí poslední svíčku pro každý časový rámec

Vzory historických dotazů

Časové dotazy

Dotaz na časový rozsah
// Dotaz na konkrétní časový rozsah
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  start_time=1709894400000&
  end_time=1709980800000
// Nebo použijte relativní lookback
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1d&
  lookback=90d

Stránkování velkých datových sad

Vzor stránkování
// První stránka: 1000 svíček
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  limit=1000&
  start_time=1709980800000
// Další stránka pomocí kurzoru
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  cursor=1709981000000&
  limit=1000

Agregační intervaly

Agregace s pevným časem

Agregujte data v pevných intervalech (každou hodinu, denně, týdně):

Pevná agregace
// Denní snímky po dobu 1 měsíce
GET /v1/historical/snapshots?
  metrics=whale_net_flow,funding_rate,oi&
  interval=1d&
  lookback=30d

Vlastní agregace

Agregujte přes vlastní časová okna:

Vlastní okna
// Agregujte 1minutové svíčky do 15m
GET /v1/historical/ohlcv/resample?
  symbol=BTCUSDT&
  source_timeframe=1m&
  target_timeframe=15m&
  lookback=7d

Historie pohybů velryb

Historické sledování velryb

Historie velryb
// Historické vzorce akumulace velryb
GET /v1/historical/whales?
  asset=BTC&
  metric=net_accumulation&
  interval=1d&
  lookback=365d
// Historické pohyby kolem cenových hladin
GET /v1/historical/whales/price-correlation?
  asset=ETH&
  lookback=90d

Struktura dat velryb

Datový bod velryby
{
 "timestamp": 1709980800000,
 "asset": "BTC",
 "metric": "net_accumulation",
 "value": 50000,  // BTC
 "whale_count": 847,
 "exchange_inflow": -12000,
 "exchange_outflow": 62000
}

Historie funding rate

Historické snímky funding rate

Historie funding rate
// Získejte hodinové snímky funding rate
GET /v1/historical/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance&
  interval=1h&
  lookback=30d
// Porovnejte historické sazby napříč burzami
GET /v1/historical/derivatives/funding-heatmap/comparative?
  symbol=ETHUSDT&
  exchanges=bybit,binance,hyperliquid&
  interval=4h&
  lookback=90d

Statistiky funding rate

Dotaz na agregované statistiky funding rate:

Statistický dotaz
GET /v1/historical/derivatives/funding-stats?
  symbol=BTCUSDT&
  lookback=365d&
  metrics=mean,median,std_dev,min,max
// Odpověď zahrnuje:
// - Roční průměrný funding rate
// - Distribuce (směrodatná odchylka)
// - Historické extrémy
// - Percentilové pořadí

Přístup k datům pro backtesting

Formát dotazu pro backtesting

Optimalizováno pro backtestingové frameworky jako Backtrader, VectorBT a vlastní enginy:

Data pro backtesting
// Získejte všechna data pro 1roční backtest
GET /v1/backtest/data?
  symbols=BTCUSDT,ETHUSDT&
  timeframe=1h&
  start=2024-01-01&
  end=2025-01-01&
  fields=ohlcv,funding_rate,oi,whale_flow

Formáty exportu

Stáhněte si historická data pro offline analýzu:

CSV — Standardní sloupcový formát pro tabulky
JSON — Strukturovaný formát se všemi metadaty
Parquet — Komprimovaný sloupcový formát pro data science
HDF5 — Formát optimalizovaný pro časové řady

Exportní dotaz
// Export jako CSV
GET /v1/backtest/export?
  symbols=BTCUSDT&
  timeframe=1d&
  lookback=365d&
  format=csv

Praktické příklady

Příklad 1: Analýza býčího trhu 2024

Analýza býčího trhu
// Korelace pohybu velryb s cenovým pohybem
GET /v1/historical/correlated-data?
  asset=BTC&
  start_time=2024-01-01&
  end_time=2024-12-31&
  include=ohlcv,whale_accumulation,funding_rates&
  interval=1d

Příklad 2: Backtestování strategie funding rate

Backtest strategie
// Získání dat pro strategii mean reversion funding rate
GET /v1/backtest/data?
  symbols=BTCUSDT,ETHUSDT,BNBUSDT&
  timeframe=4h&
  start=2023-01-01&
  end=2025-01-01&
  exchange=binance&
  fields=funding_rate,open_interest,liquidations

Osvědčené postupy pro historická data

1. Zvolte vhodné časové rámce

Použijte nejmenší potřebný časový rámec. 1minutová data jsou dražší než hodinová.

2. Specifikujte časové rozsahy

Vždy používejte parametry start_time/end_time nebo lookback. Neomezené dotazy jsou neefektivní.

3. Ukládejte historické dotazy do mezipaměti

Historická data jsou neměnná. Agresivně ukládejte do mezipaměti (30denní TTL pro měsíční data).

4. Používejte stránkování pro velké výsledky

1minutová data za 1 rok = 525 600 svíček. Pro velké datasety použijte stránkování a streamování.

5. Ověřte úplnost dat

Před analýzou zkontrolujte v metadatech odpovědi mezery nebo chybějící burzy.

Přístup k historickým datům pro výzkum

24 měsíců OHLCV dat, pohybů velryb a funding rate dat. Ideální pro backtesting, výzkum a vývoj strategií.

Zobrazit plány

Volná verze: 30d historie. Pro: 24 měsíců. Enterprise: Přístup k celému archivu.