Dokumentasi API
Data Siri Masa dan Pertanyaan Analisis Sejarah
Akses data siri masa yang komprehensif untuk ujian balik, penyelidikan, dan analisis sejarah. Pertanyaan lilin OHLCV, kadar pembiayaan sejarah, garis masa pergerakan ikan paus, dan snapshot pasaran terkumpul merentasi pelbagai tempoh masa.
Diterbitkan pada 21 Mac 2026
•
15 minit baca
•
Penyelidikan
Gambaran Keseluruhan Data Sejarah
Smart Money API menyediakan data sejarah 24 bulan yang membolehkan penyelidikan komprehensif, ujian balik, dan analisis berasaskan masa. Semua data sejarah dinormalisasi, diduplikasi, dan tersedia pada pelbagai tahap pengumpulan.
Data sejarah yang tersedia termasuk:
- Lilin OHLCV — Buka, Tinggi, Rendah, Tutup, Isipadu untuk semua pasangan dagangan
- Pergerakan Ikan Paus — Pengumpulan/pengedaran sejarah pada resolusi harian dan setiap jam
- Kadar Pembiayaan — Snapshot kadar pembiayaan sejarah untuk semua pasangan kekal
- Faedah Terbuka — Data OI sejarah merentasi semua pertukaran dan tempoh masa
- Pelepasan — Kaskad dan titik tekanan pelepas sejarah
Pengekalan Data: Data tik penuh disimpan selama 90 hari. Data terkumpul setiap jam/harian disimpan selama 24 bulan. Arkib mentah tersedia untuk muat turun.
Data Lilin OHLCV
Data Buka-Tinggi-Rendah-Tutup-Isipadu untuk analisis teknikal dan carta. Tersedia untuk semua pasangan kripto merentasi tempoh masa dari 1 minit hingga 1 bulan.
Struktur Data 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
}
Pertanyaan Data OHLCV
// Dapatkan lilin 1 jam untuk 30 hari terakhir
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1h&
lookback=30d&
limit=720
Dapatkan kunci API anda dalam 30 saat
Sedia untuk membina? Dapatkan kunci API percuma (100 panggilan/hari, tiada kad) dan mula menarik data ikan paus, pembiayaan dan on-chain secara langsung.
Dapatkan kunci API anda →
Tempoh Masa yang Tersedia
Pilihan Tempoh Masa
| Tempoh Masa |
Tempoh |
Kegunaan |
Lihat Balik Maksimum |
| 1m |
1 minit |
Perdagangan frekuensi tinggi, scalping |
30 hari |
| 5m |
5 minit |
Intraday, swing trading |
90 hari |
| 15m |
15 minit |
Perdagangan harian, pengesanan isyarat |
180 hari |
| 1h |
1 jam |
Perdagangan jangka sederhana, analisis |
365 hari |
| 4h |
4 jam |
Swing trading, analisis trend |
24 bulan |
| 1d |
1 hari |
Posisi jangka panjang, penyelidikan |
24 bulan |
| 1w |
1 minggu |
Analisis makro, trend pelbagai tahun |
24 bulan |
| 1M |
1 bulan |
Posisi strategik |
24 bulan |
Gabungan Tempoh Masa
Pertanyaan pelbagai tempoh masa serentak:
GET /v1/historical/ohlcv/multi?
symbol=BTCUSDT&
timeframes=1h,4h,1d&
timestamp=1709980800000
// Mengembalikan lilin terkini untuk setiap tempoh masa
Corak Pertanyaan Sejarah
Pertanyaan Berasaskan Masa
// Pertanyaan julat masa tertentu
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1h&
start_time=1709894400000&
end_time=1709980800000
// Atau gunakan lihat balik relatif
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1d&
lookback=90d
Paginasi untuk Set Data Besar
// Halaman pertama: 1000 lilin
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1m&
limit=1000&
start_time=1709980800000
// Halaman seterusnya menggunakan kursor
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1m&
cursor=1709981000000&
limit=1000
Selang Pengagregatan
Pengagregatan Masa Tetap
Agregat data pada selang tetap (setiap jam, harian, mingguan):
// Snapshot harian untuk 1 bulan
GET /v1/historical/snapshots?
metrics=whale_net_flow,funding_rate,oi&
interval=1d&
lookback=30d
Pengagregatan Tersuai
Agregat atas tetingkap masa tersuai:
// Agregat lilin 1-minit kepada 15m
GET /v1/historical/ohlcv/resample?
symbol=BTCUSDT&
source_timeframe=1m&
target_timeframe=15m&
lookback=7d
Sejarah Pergerakan Ikan Paus
Penjejakan Ikan Paus Sejarah
// Corak pengumpulan ikan paus sejarah
GET /v1/historical/whales?
asset=BTC&
metric=net_accumulation&
interval=1d&
lookback=365d
// Pergerakan sejarah sekitar paras harga
GET /v1/historical/whales/price-correlation?
asset=ETH&
lookback=90d
Struktur Data Ikan Paus
{
"timestamp": 1709980800000,
"asset": "BTC",
"metric": "net_accumulation",
"value": 50000,
"whale_count": 847,
"exchange_inflow": -12000,
"exchange_outflow": 62000
}
Sejarah Kadar Pembiayaan
Snapshot Kadar Pembiayaan Sejarah
// Dapatkan snapshot kadar pembiayaan setiap jam
GET /v1/historical/derivatives/funding-heatmap?
symbol=BTCUSDT&
exchange=binance&
interval=1h&
lookback=30d
// Bandingkan kadar sejarah merentasi pertukaran
GET /v1/historical/derivatives/funding-heatmap/comparative?
symbol=ETHUSDT&
exchanges=bybit,binance,hyperliquid&
interval=4h&
lookback=90d
Statistik Kadar Pembiayaan
Kueri statistik kadar pembiayaan agregat:
GET /v1/historical/derivatives/funding-stats?
symbol=BTCUSDT&
lookback=365d&
metrics=mean,median,std_dev,min,max
// Respons termasuk:
// - Purata kadar pembiayaan tahunan
// - Taburan (std dev)
// - Ekstrem sejarah
// - Kedudukan persentil
Akses Data Ujian Balik
Format Kueri Ujian Balik
Dioptimumkan untuk rangka kerja ujian balik seperti Backtrader, VectorBT, dan enjin tersuai:
// Dapatkan semua data untuk ujian balik 1-tahun
GET /v1/backtest/data?
symbols=BTCUSDT,ETHUSDT&
timeframe=1h&
start=2024-01-01&
end=2025-01-01&
fields=ohlcv,funding_rate,oi,whale_flow
Format Eksport
Muat turun data sejarah untuk analisis luar talian:
- CSV — Format berkolum standard untuk hamparan elektronik
- JSON — Format berstruktur dengan semua metadata
- Parquet — Format berkolum termampat untuk sains data
- HDF5 — Format dioptimumkan untuk siri masa
// Eksport sebagai CSV
GET /v1/backtest/export?
symbols=BTCUSDT&
timeframe=1d&
lookback=365d&
format=csv
Contoh Praktikal
Contoh 1: Penyelidikan Pasaran Lembu 2024
// Hubungkan pergerakan ikan paus dengan tindakan harga
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
Contoh 2: Menguji Strategi Kadar Pembiayaan Secara Backtesting
// Dapatkan data untuk strategi pembalikan min kadar pembiayaan
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
Amalan Terbaik Data Sejarah
1. Pilih Tempoh Masa Yang Sesuai
Gunakan tempoh masa terkecil yang diperlukan untuk analisis anda. Data 1 minit lebih mahal daripada data setiap jam.
2. Nyatakan Julat Masa
Sentiasa gunakan start_time/end_time atau parameter lookback. Pertanyaan tanpa had tidak efisien.
3. Cache Pertanyaan Sejarah
Data sejarah tidak berubah. Cache secara agresif (TTL 30 hari untuk data bulanan).
4. Gunakan Penomboran Halaman untuk Hasil Besar
Data 1 minit selama 1 tahun = 525,600 lilin. Gunakan penomboran halaman dan strim untuk set data besar.
5. Sahkan Kelengkapan Data
Periksa metadata respons untuk jurang atau pertukaran yang tiada sebelum menggunakan data dalam analisis.
Akses Data Sejarah untuk Penyelidikan
24 bulan data OHLCV, pergerakan ikan paus, dan data kadar pembiayaan. Sesuai untuk backtesting, penyelidikan, dan pembangunan strategi.
Lihat Pelan
Tingkat percuma: sejarah 30 hari. Pro: 24 bulan. Enterprise: Akses arkib penuh.