Daftar Isi

Ikhtisar Lilin OHLCV Opsi Timeframe Kueri Historis Interval Agregasi Riwayat Pergerakan Whale Riwayat Funding Rate Data Backtesting Contoh Penggunaan Praktik Terbaik

Dokumentasi API

Data Time Series dan Kueri Analisis Historis

Akses data time series komprehensif untuk backtesting, penelitian, dan analisis historis. Kueri lilin OHLCV, riwayat funding rate, timeline pergerakan whale, dan snapshot pasar teragregasi di berbagai timeframe.

Diterbitkan 21 Maret 2026 • 15 menit dibaca • Penelitian

Ikhtisar Data Historis

Smart Money API menyediakan data historis 24 bulan yang memungkinkan penelitian komprehensif, backtesting, dan analisis berbasis waktu. Semua data historis dinormalisasi, dihilangkan duplikatnya, dan tersedia di berbagai tingkat agregasi.

Data historis yang tersedia meliputi:

Lilin OHLCV — Open, High, Low, Close, Volume untuk semua pair yang diperdagangkan
Pergerakan Whale — Akumulasi/distribusi historis dengan resolusi harian dan per jam
Funding Rates — Snapshot funding rate historis untuk semua pair perpetual
Open Interest — Data OI historis di semua bursa dan timeframe
Liquidations — Cascade liquidation dan titik tekanan historis

Retensi Data: Data tick penuh disimpan selama 90 hari. Data teragregasi per jam/hari disimpan selama 24 bulan. Arsip mentah tersedia untuk diunduh.

Data Lilin OHLCV

Data Open-High-Low-Close-Volume untuk analisis teknis dan pembuatan grafik. Tersedia untuk semua pair cryptocurrency di timeframe dari 1 menit hingga 1 bulan.

Struktur Data OHLCV

Lilin 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
}

Kueri Data OHLCV

Kueri OHLCV Historis
// 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 detik

Siap membangun? Dapatkan kunci API gratis (100 panggilan/hari, tanpa kartu) dan mulai menarik data whale, funding, dan on-chain langsung.

Dapatkan kunci API Anda →

Timeframe yang Tersedia

Opsi Timeframe

Timeframe	Durasi	Kasus Penggunaan	Lookback Maksimal
1m	1 menit	Trading frekuensi tinggi, scalping	30 hari
5m	5 menit	Intraday, swing trading	90 hari
15m	15 menit	Day trading, deteksi sinyal	180 hari
1h	1 jam	Trading jangka menengah, analisis	365 hari
4h	4 jam	Swing trading, analisis tren	24 bulan
1d	1 hari	Posisi jangka panjang, penelitian	24 bulan
1w	1 minggu	Analisis makro, tren multi-tahun	24 bulan
1M	1 bulan	Posisi strategis	24 bulan

Kombinasi Timeframe

Kueri beberapa timeframe secara bersamaan:

Kueri Multi-Timeframe
GET /v1/historical/ohlcv/multi?
  symbol=BTCUSDT&
  timeframes=1h,4h,1d&
  timestamp=1709980800000
// Mengembalikan lilin terbaru untuk setiap timeframe

Pola Kueri Historis

Kueri Berbasis Waktu

Kueri Rentang Waktu
// Kueri rentang waktu spesifik
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  start_time=1709894400000&
  end_time=1709980800000
// Atau gunakan lookback relatif
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1d&
  lookback=90d

Paginasi untuk Dataset Besar

Pola Paginasi
// Halaman pertama: 1000 candle
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  limit=1000&
  start_time=1709980800000
// Halaman berikutnya menggunakan kursor
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  cursor=1709981000000&
  limit=1000

Interval Agregasi

Agregasi Waktu Tetap

Agregasi data pada interval tetap (per jam, harian, mingguan):

Agregasi Tetap
// Snapshot harian selama 1 bulan
GET /v1/historical/snapshots?
  metrics=whale_net_flow,funding_rate,oi&
  interval=1d&
  lookback=30d

Agregasi Kustom

Agregasi selama jendela waktu kustom:

Jendela Kustom
// Agregasi candle 1-menit menjadi 15m
GET /v1/historical/ohlcv/resample?
  symbol=BTCUSDT&
  source_timeframe=1m&
  target_timeframe=15m&
  lookback=7d

Riwayat Pergerakan Paus

Pelacakan Paus Historis

Riwayat Paus
// Pola akumulasi paus historis
GET /v1/historical/whales?
  asset=BTC&
  metric=net_accumulation&
  interval=1d&
  lookback=365d
// Pergerakan historis di sekitar level harga
GET /v1/historical/whales/price-correlation?
  asset=ETH&
  lookback=90d

Struktur Data Paus

Titik Data Paus
{
 "timestamp": 1709980800000,
 "asset": "BTC",
 "metric": "net_accumulation",
 "value": 50000,  // BTC
 "whale_count": 847,
 "exchange_inflow": -12000,
 "exchange_outflow": 62000
}

Riwayat Funding Rate

Snapshot Funding Rate Historis

Riwayat Funding Rate
// Ambil snapshot funding rate per jam
GET /v1/historical/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance&
  interval=1h&
  lookback=30d
// Bandingkan funding rate historis antar exchange
GET /v1/historical/derivatives/funding-heatmap/comparative?
  symbol=ETHUSDT&
  exchanges=bybit,binance,hyperliquid&
  interval=4h&
  lookback=90d

Statistik Funding Rate

Kueri statistik funding rate yang diagregasi:

Kueri Statistik
GET /v1/historical/derivatives/funding-stats?
  symbol=BTCUSDT&
  lookback=365d&
  metrics=mean,median,std_dev,min,max
// Respons termasuk:
// - Rata-rata funding rate tahunan
// - Distribusi (std dev)
// - Ekstrem historis
// - Peringkat persentil

Akses Data Backtesting

Format Kueri Backtesting

Dioptimalkan untuk framework backtesting seperti Backtrader, VectorBT, dan mesin kustom:

Data Backtest
// Ambil semua data untuk backtest 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 Ekspor

Unduh data historis untuk analisis offline:

CSV — Format kolom standar untuk spreadsheet
JSON — Format terstruktur dengan semua metadata
Parquet — Format kolom terkompresi untuk ilmu data
HDF5 — Format optimal untuk time series

Kueri Ekspor
// Ekspor sebagai CSV
GET /v1/backtest/export?
  symbols=BTCUSDT&
  timeframe=1d&
  lookback=365d&
  format=csv

Contoh Praktis

Contoh 1: Riset Bull Market 2024

Analisis Bull Market
// Korelasi pergerakan paus dengan aksi 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: Backtesting Strategi Funding Rate

Backtest Strategi
// Ambil data untuk strategi 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

Best Practices Data Historis

1. Pilih Timeframe yang Sesuai

Gunakan timeframe terkecil yang diperlukan untuk analisis Anda. Data 1-menit lebih mahal daripada data per jam.

2. Tentukan Rentang Waktu

Selalu gunakan parameter start_time/end_time atau lookback. Kueri tanpa batas waktu tidak efisien.

3. Cache Kueri Historis

Data historis tidak berubah. Cache secara agresif (TTL 30 hari untuk data bulanan).

4. Gunakan Paginasi untuk Hasil Besar

Data 1-menit selama 1 tahun = 525.600 candle. Gunakan paginasi dan streaming untuk dataset besar.

5. Validasi Kelengkapan Data

Periksa metadata respons untuk celah atau pertukaran yang hilang sebelum menggunakan data dalam analisis.

Akses Data Historis untuk Penelitian

24 bulan data OHLCV, pergerakan whale, dan funding rate. Sempurna untuk backtesting, penelitian, dan pengembangan strategi.

Lihat Paket

Tingkat gratis: riwayat 30d. Pro: 24 bulan. Enterprise: Akses arsip lengkap.