Dokumentacja API
Dane szeregów czasowych i zapytania analizy historycznej
Uzyskaj dostęp do kompleksowych danych szeregów czasowych do backtestingu, badań i analizy historycznej. Wykonuj zapytania dotyczące świeczników OHLCV, historycznych stawek finansowania, harmonogramów ruchów wielorybów i zagregowanych migawek rynku w wielu przedziałach czasowych.
Opublikowano 21 marca 2026
•
15 minut czytania
•
Badania
Przegląd danych historycznych
Smart Money API zapewnia 24 miesiące danych historycznych umożliwiających kompleksowe badania, backtesting i analizę czasową. Wszystkie dane historyczne są znormalizowane, pozbawione duplikatów i dostępne na wielu poziomach agregacji.
Dostępne dane historyczne obejmują:
- Świeczniki OHLCV — Otwarcie, maksimum, minimum, zamknięcie, wolumen dla wszystkich par handlowych
- Ruchy wielorybów — Historyczna akumulacja/dystrybucja w rozdzielczości dziennej i godzinowej
- Stawki finansowania — Historyczne migawki stawek finansowania dla wszystkich par perpetual
- Otwarte zainteresowanie — Historyczne dane OI dla wszystkich giełd i przedziałów czasowych
- Likwidacje — Historyczne kaskady likwidacji i punkty nacisku
Przechowywanie danych: Pełne dane tickowe przechowywane przez 90 dni. Zagregowane dane godzinowe/dzienne przechowywane przez 24 miesiące. Surowce archiwa dostępne do pobrania.
Dane świeczników OHLCV
Dane Open-High-Low-Close-Volume do analizy technicznej i tworzenia wykresów. Dostępne dla wszystkich par kryptowalutowych w przedziałach czasowych od 1 minuty do 1 miesiąca.
Struktura danych OHLCV
{
"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
}
Zapytanie o dane OHLCV
// Pobierz świeczniki 1-godzinne z ostatnich 30 dni
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1h&
lookback=30d&
limit=720
Uzyskaj klucz API w 30 sekund
Gotowy do budowania? Zdobądź darmowy klucz API (200 wywołań/dzień, bez karty) i zacznij pobierać dane o wielorybach, finansowaniu i danych on-chain w czasie rzeczywistym.
Uzyskaj klucz API →Dostępne przedziały czasowe
Opcje przedziałów czasowych
| Przedział czasowy |
Czas trwania |
Przypadek użycia |
Maksymalny okres wstecz |
| 1m |
1 minuta |
Handel wysokiej częstotliwości, skalpowanie |
30 dni |
| 5m |
5 minut |
Handel wewnątrzdniowy, swing trading |
90 dni |
| 15m |
15 minut |
Day trading, wykrywanie sygnałów |
180 dni |
| 1h |
1 godzina |
Handel średnioterminowy, analiza |
365 dni |
| 4h |
4 godziny |
Swing trading, analiza trendów |
24 miesiące |
| 1d |
1 dzień |
Pozycjonowanie długoterminowe, badania |
24 miesiące |
| 1w |
1 tydzień |
Analiza makro, trendy wieloletnie |
24 miesiące |
| 1M |
1 miesiąc |
Pozycjonowanie strategiczne |
24 miesiące |
Kombinacje przedziałów czasowych
Wykonuj zapytania dotyczące wielu przedziałów czasowych jednocześnie:
GET /v1/historical/ohlcv/multi?
symbol=BTCUSDT&
timeframes=1h,4h,1d&
timestamp=1709980800000
// Zwraca najnowszy świecznik dla każdego przedziału czasowego
Wzorce zapytań historycznych
Zapytania czasowe
// Zapytanie o konkretny zakres czasowy
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1h&
start_time=1709894400000&
end_time=1709980800000
// Lub użyj względnego okresu wstecz
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1d&
lookback=90d
Paginacja dużych zbiorów danych
// Pierwsza strona: 1000 świec
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1m&
limit=1000&
start_time=1709980800000
// Następna strona przy użyciu kursora
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1m&
cursor=1709981000000&
limit=1000
Interwały agregacji
Agregacja w stałych odstępach czasu
Agreguj dane w stałych interwałach (co godzinę, codziennie, co tydzień):
// Codzienne migawki przez 1 miesiąc
GET /v1/historical/snapshots?
metrics=whale_net_flow,funding_rate,oi&
interval=1d&
lookback=30d
Niestandardowa agregacja
Agreguj w niestandardowych oknach czasowych:
// Agreguj 1-minutowe świece w 15-minutowe
GET /v1/historical/ohlcv/resample?
symbol=BTCUSDT&
source_timeframe=1m&
target_timeframe=15m&
lookback=7d
Historia ruchów wielorybów
Śledzenie historycznych wielorybów
// Historyczne wzorce akumulacji wielorybów
GET /v1/historical/whales?
asset=BTC&
metric=net_accumulation&
interval=1d&
lookback=365d
// Historyczne ruchy wokół poziomów cenowych
GET /v1/historical/whales/price-correlation?
asset=ETH&
lookback=90d
Struktura danych wielorybów
{
"timestamp": 1709980800000,
"asset": "BTC",
"metric": "net_accumulation",
"value": 50000,
"whale_count": 847,
"exchange_inflow": -12000,
"exchange_outflow": 62000
}
Historia stóp finansowania
Historyczne migawki stóp finansowania
// Pobierz migawki stóp finansowania co godzinę
GET /v1/historical/derivatives/funding-heatmap?
symbol=BTCUSDT&
exchange=binance&
interval=1h&
lookback=30d
// Porównaj historyczne stopy między giełdami
GET /v1/historical/derivatives/funding-heatmap/comparative?
symbol=ETHUSDT&
exchanges=bybit,binance,hyperliquid&
interval=4h&
lookback=90d
Statystyki stóp finansowania
Zapytanie o zagregowane statystyki stóp finansowania:
GET /v1/historical/derivatives/funding-stats?
symbol=BTCUSDT&
lookback=365d&
metrics=mean,median,std_dev,min,max
// Odpowiedź zawiera:
// - Średnią roczną stopę finansowania
// - Rozkład (odchylenie standardowe)
// - Historyczne ekstrema
// - Rangi percentylowe
Dostęp do danych backtestowych
Format zapytania backtestowego
Zoptymalizowane dla frameworków backtestowych takich jak Backtrader, VectorBT i niestandardowych silników:
// Pobierz wszystkie dane do 1-rocznego backtestu
GET /v1/backtest/data?
symbols=BTCUSDT,ETHUSDT&
timeframe=1h&
start=2024-01-01&
end=2025-01-01&
fields=ohlcv,funding_rate,oi,whale_flow
Formaty eksportu
Pobierz historyczne dane do analizy offline:
- CSV — Standardowy format kolumnowy dla arkuszy kalkulacyjnych
- JSON — Ustrukturyzowany format z wszystkimi metadanymi
- Parquet — Skompresowany format kolumnowy dla data science
- HDF5 — Format zoptymalizowany dla szeregów czasowych
// Eksportuj jako CSV
GET /v1/backtest/export?
symbols=BTCUSDT&
timeframe=1d&
lookback=365d&
format=csv
Praktyczne przykłady
Przykład 1: Badanie hossy w 2024 roku
// Skorelowanie ruchów wielorybów z akcją cenową
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
Przykład 2: Backtestowanie strategii stopy finansowania
// Pobierz dane dla strategii mean reversion stopy finansowania
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
Najlepsze praktyki dotyczące danych historycznych
1. Wybierz odpowiednie ramy czasowe
Użyj najmniejszej ramy czasowej potrzebnej do analizy. Dane minutowe są droższe niż godzinowe.
2. Określ zakresy czasowe
Zawsze używaj parametrów start_time/end_time lub lookback. Zapytania bez określenia końca są nieefektywne.
3. Buforuj zapytania historyczne
Dane historyczne są niezmienne. Buforuj agresywnie (30-dniowy TTL dla danych miesięcznych).
4. Używaj paginacji dla dużych wyników
Dane minutowe przez 1 rok = 525,600 świec. Używaj paginacji i strumieniowania dla dużych zbiorów danych.
5. Sprawdź kompletność danych
Sprawdź metadane odpowiedzi pod kątem luk lub brakujących giełd przed użyciem danych w analizie.
Dostęp do danych historycznych do badań
24 miesiące danych OHLCV, ruchów wielorybów i stóp finansowania. Idealne do backtestowania, badań i rozwoju strategii.
Zobacz plany
Darmowy poziom: 30d historii. Pro: 24 miesiące. Enterprise: Pełny dostęp do archiwum.