Documentație API
Date de Serii Temporale și Interogări de Analiză Istorică
Accesează date complete de serii temporale pentru backtesting, cercetare și analiză istorică. Interoghează sfește OHLCV, rate istorice de finanțare, cronologii ale mișcărilor balenelor și instantanee agregate ale pieței pe mai multe intervale de timp.
Publicat pe 21 martie 2026
•
15 minute de citit
•
Cercetare
Prezentare generală a Datelor Istorice
Smart Money API oferă date istorice pe 24 de luni, permițând cercetare cuprinzătoare, backtesting și analiză bazată pe timp. Toate datele istorice sunt normalizate, deduplicate și disponibile la mai multe niveluri de agregare.
Datele istorice disponibile includ:
- Sfește OHLCV — Deschidere, Maximă, Minimă, Închidere, Volum pentru toate perechile tranzacționate
- Mișcări ale Balenelor — Acumulare/distribuție istorică la rezoluție zilnică și orară
- Rate de Finanțare — Instantanee istorice ale ratei de finanțare pentru toate perechile perpetue
- Interes Deschis — Date istorice ID pe toate schimburile și intervalele de timp
- Lichidări — Cascade istorice de lichidări și puncte de presiune
Păstrarea Datelor: Datele complete de tick sunt păstrate timp de 90 de zile. Datele agregate orare/zilnice sunt păstrate timp de 24 de luni. Arhivele brute sunt disponibile pentru descărcare.
Datele Sfeștelor OHLCV
Date Deschidere-Maximă-Minimă-Închidere-Volum pentru analiză tehnică și trasare de grafice. Disponibile pentru toate perechile de criptomonede pe intervale de la 1 minut la 1 lună.
Structura Datelor 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
}
Interogare Date OHLCV
// Obține sfește de 1 oră pentru ultimele 30 de zile
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1h&
lookback=30d&
limit=720
Obține cheia API în 30 de secunde
Gata să construiești? Ia o cheie API gratuită (50 de apeluri/zi, fără card) și începe să extragi date live despre balene, finanțare și on-chain.
Obține cheia API →
Intervale de Timp Disponibile
Opțiuni de Interval de Timp
| Interval de Timp |
Durată |
Caz de Utilizare |
Max Lookback |
| 1m |
1 minut |
Tranzacționare de înaltă frecvență, scalping |
30 de zile |
| 5m |
5 minute |
Tranzacționare intraday, swing trading |
90 de zile |
| 15m |
15 minute |
Tranzacționare pe zi, detectare de semnale |
180 de zile |
| 1h |
1 oră |
Tranzacționare pe termen mediu, analiză |
365 de zile |
| 4h |
4 ore |
Swing trading, analiză de trend |
24 de luni |
| 1d |
1 zi |
Poziționare pe termen lung, cercetare |
24 de luni |
| 1w |
1 săptămână |
Analiză macro, tendințe pe mai mulți ani |
24 de luni |
| 1M |
1 lună |
Poziționare strategică |
24 de luni |
Combinații de Intervale de Timp
Interoghează mai multe intervale de timp simultan:
GET /v1/historical/ohlcv/multi?
symbol=BTCUSDT&
timeframes=1h,4h,1d&
timestamp=1709980800000
// Returnează ultima sfeastă pentru fiecare interval de timp
Modele de Interogare Istorică
Interogări Bazate pe Timp
// Interoghează un interval de timp specific
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1h&
start_time=1709894400000&
end_time=1709980800000
// Sau folosește lookback relativ
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1d&
lookback=90d
Paginare pentru seturi mari de date
// Prima pagină: 1000 de lumânări
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1m&
limit=1000&
start_time=1709980800000
// Pagina următoare folosind cursor
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1m&
cursor=1709981000000&
limit=1000
Intervale de agregare
Agregare la timp fix
Agregați date la intervale fixe (orar, zilnic, săptămânal):
// Instantanee zilnice pentru 1 lună
GET /v1/historical/snapshots?
metrics=whale_net_flow,funding_rate,oi&
interval=1d&
lookback=30d
Agregare personalizată
Agregați pe ferestre de timp personalizate:
// Agregați lumânări de 1 minut în 15m
GET /v1/historical/ohlcv/resample?
symbol=BTCUSDT&
source_timeframe=1m&
target_timeframe=15m&
lookback=7d
Istoric mișcări Whale
Urmărire istorică Whale
// Modele istorice de acumulare Whale
GET /v1/historical/whales?
asset=BTC&
metric=net_accumulation&
interval=1d&
lookback=365d
// Mișcări istorice în jurul nivelurilor de preț
GET /v1/historical/whales/price-correlation?
asset=ETH&
lookback=90d
Structura datelor Whale
{
"timestamp": 1709980800000,
"asset": "BTC",
"metric": "net_accumulation",
"value": 50000,
"whale_count": 847,
"exchange_inflow": -12000,
"exchange_outflow": 62000
}
Istoric rata de funding
Istoric instantanee rata de funding
// Obțineți instantanee orare ale ratei de funding
GET /v1/historical/derivatives/funding-heatmap?
symbol=BTCUSDT&
exchange=binance&
interval=1h&
lookback=30d
// Comparați rate istorice între exchange-uri
GET /v1/historical/derivatives/funding-heatmap/comparative?
symbol=ETHUSDT&
exchanges=bybit,binance,hyperliquid&
interval=4h&
lookback=90d
Statistici rata de funding
Interogare statistici agregate ale ratei de funding:
GET /v1/historical/derivatives/funding-stats?
symbol=BTCUSDT&
lookback=365d&
metrics=mean,median,std_dev,min,max
// Răspunsul include:
// - Rata medie anuală de funding
// - Distribuție (deviație standard)
// - Extreme istorice
// - Clasamente pe percentile
Acces date pentru backtesting
Format interogare backtesting
Optimizat pentru framework-uri de backtesting precum Backtrader, VectorBT și motoare personalizate:
// Obțineți toate datele pentru un backtest de 1 an
GET /v1/backtest/data?
symbols=BTCUSDT,ETHUSDT&
timeframe=1h&
start=2024-01-01&
end=2025-01-01&
fields=ohlcv,funding_rate,oi,whale_flow
Formate de export
Descărcați date istorice pentru analiză offline:
- CSV — Format standard coloană pentru foi de calcul
- JSON — Format structurat cu toate metadatele
- Parquet — Format coloană comprimat pentru știința datelor
- HDF5 — Format optimizat pentru serii temporale
// Exportă ca CSV
GET /v1/backtest/export?
symbols=BTCUSDT&
timeframe=1d&
lookback=365d&
format=csv
Exemple practice
Exemplu 1: Analiza pieței bullish din 2024
// Corelați mișcările Whale cu acțiunile de preț
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
Exemplul 2: Testarea în trecut a strategiei bazate pe rata de finanțare
// Obține date pentru strategia de revenire la medie a ratei de finanțare
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
Cele mai bune practici pentru date istorice
1. Alege intervale de timp adecvate
Folosește cel mai mic interval de timp necesar pentru analiza ta. Datele pe minut sunt mai costisitoare decât cele orare.
2. Specifică intervale de timp
Folosește întotdeauna parametrii start_time/end_time sau lookback. Interogările deschise sunt ineficiente.
3. Cache pentru interogări istorice
Datele istorice sunt imuabile. Folosește cache agresiv (TTL de 30 de zile pentru date lunare).
4. Folosește paginare pentru rezultate mari
Datele pe minut pe 1 an = 525.600 de lumânări. Folosește paginare și streaming pentru seturi de date mari.
5. Verifică completitudinea datelor
Verifică metadatele răspunsului pentru lacune sau exchange-uri lipsă înainte de a folosi datele în analiză.
Accesează date istorice pentru cercetare
24 de luni de date OHLCV, mișcări ale balenelor și rate de finanțare. Perfect pentru testarea în trecut, cercetare și dezvoltare de strategii.
Vezi planurile
Nivel gratuit: istoric de 30d. Pro: 24 luni. Enterprise: Acces la arhivă completă.