Inhoudsopgave

Overzicht OHLCV Candles Tijdsinterval Opties Historische Query's Aggregatie Intervallen Whale Movement Geschiedenis Funding Rate Geschiedenis Backtesting Data Gebruiksvoorbeelden Beste Praktijken

API Documentatie

Time Series Data en Historische Analyse Query's

Toegang tot uitgebreide time series data voor backtesting, onderzoek en historische analyse. Query OHLCV candles, historische funding rates, whale movement tijdlijnen en geaggregeerde marktmomentopnames over meerdere tijdsintervallen.

Gepubliceerd op 21 maart 2026 • 15 min leestijd • Onderzoek

Historische Data Overzicht

Smart Money API biedt 24 maanden aan historische data voor uitgebreid onderzoek, backtesting en tijdgebonden analyse. Alle historische data is genormaliseerd, gededupliceerd en beschikbaar op meerdere aggregatieniveaus.

Beschikbare historische data omvat:

OHLCV Candles — Open, High, Low, Close, Volume voor alle verhandelde paren
Whale Movements — Historische accumulatie/distributie op dagelijkse en uurlijkse resolutie
Funding Rates — Historische funding rate momentopnames voor alle perpetual paren
Open Interest — Historische OI data over alle exchanges en tijdsintervallen
Liquidations — Historische liquidatie cascades en drukpunten

Data Retentie: Volledige tick data bewaard voor 90 dagen. Geaggregeerde uurlijkse/dagelijkse data bewaard voor 24 maanden. Ruwe archieven beschikbaar voor download.

OHLCV Candlestick Data

Open-High-Low-Close-Volume data voor technische analyse en charting. Beschikbaar voor alle cryptocurrency paren over tijdsintervallen van 1 minuut tot 1 maand.

OHLCV Data Structuur

OHLCV Candlestick
{
 "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
}

Query OHLCV Data

Historische OHLCV Query
// Haal 1-uurs candles voor de laatste 30 dagen
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  lookback=30d&
  limit=720

Krijg je API-sleutel in 30 seconden

Klaar om te bouwen? Pak een gratis API-sleutel (200 calls/dag, geen kaart nodig) en begin live whale, funding en on-chain data op te halen.

Krijg je API-sleutel →

Beschikbare Tijdsintervallen

Tijdsinterval Opties

Tijdsinterval	Duur	Gebruiksscenario	Max Lookback
1m	1 minuut	High-frequency trading, scalping	30 dagen
5m	5 minuten	Intraday, swing trading	90 dagen
15m	15 minuten	Day trading, signaaldetectie	180 dagen
1h	1 uur	Medium-term trading, analyse	365 dagen
4h	4 uur	Swing trading, trendanalyse	24 maanden
1d	1 dag	Langetermijn positionering, onderzoek	24 maanden
1w	1 week	Macro analyse, meerjarige trends	24 maanden
1M	1 maand	Strategische positionering	24 maanden

Tijdsinterval Combinaties

Query meerdere tijdsintervallen tegelijk:

Multi-Timeframe Query
GET /v1/historical/ohlcv/multi?
  symbol=BTCUSDT&
  timeframes=1h,4h,1d&
  timestamp=1709980800000
// Retourneert de laatste candle voor elk tijdsinterval

Historische Query Patronen

Tijdgebonden Query's

Tijdsbereik Query
// Query specifiek tijdsbereik
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  start_time=1709894400000&
  end_time=1709980800000
// Of gebruik relatieve lookback
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1d&
  lookback=90d

Paginering voor grote datasets

Paginering patroon
// Eerste pagina: 1000 candles
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  limit=1000&
  start_time=1709980800000
// Volgende pagina met cursor
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  cursor=1709981000000&
  limit=1000

Aggregatie-intervallen

Vaste-tijd aggregatie

Aggregeer data op vaste intervallen (per uur, dagelijks, wekelijks):

Vaste aggregatie
// Dagelijkse momentopnamen voor 1 maand
GET /v1/historical/snapshots?
  metrics=whale_net_flow,funding_rate,oi&
  interval=1d&
  lookback=30d

Aangepaste aggregatie

Aggregeer over aangepaste tijdvensters:

Aangepaste vensters
// Aggregeer 1-minuut candles naar 15m
GET /v1/historical/ohlcv/resample?
  symbol=BTCUSDT&
  source_timeframe=1m&
  target_timeframe=15m&
  lookback=7d

Whale-bewegingsgeschiedenis

Historische whale-tracking

Whale-geschiedenis
// Historische whale-accumulatiepatronen
GET /v1/historical/whales?
  asset=BTC&
  metric=net_accumulation&
  interval=1d&
  lookback=365d
// Historische beweging rond prijsniveaus
GET /v1/historical/whales/price-correlation?
  asset=ETH&
  lookback=90d

Whale-datastructuur

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

Funding Rate-geschiedenis

Historische Funding Rate-momentopnamen

Funding Rate-geschiedenis
// Ontvang uurlijkse funding rate-momentopnamen
GET /v1/historical/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance&
  interval=1h&
  lookback=30d
// Vergelijk historische tarieven tussen exchanges
GET /v1/historical/derivatives/funding-heatmap/comparative?
  symbol=ETHUSDT&
  exchanges=bybit,binance,hyperliquid&
  interval=4h&
  lookback=90d

Funding Rate-statistieken

Vraag geaggregeerde funding rate-statistieken op:

Statistieken-query
GET /v1/historical/derivatives/funding-stats?
  symbol=BTCUSDT&
  lookback=365d&
  metrics=mean,median,std_dev,min,max
// Reactie bevat:
// - Jaarlijks gemiddelde funding rate
// - Verdeling (std dev)
// - Historische extremen
// - Percentiel-ranglijsten

Backtesting-data-access

Backtesting-queryformaat

Geoptimaliseerd voor backtesting-frameworks zoals Backtrader, VectorBT en aangepaste engines:

Backtest-data
// Ontvang alle data voor 1-jaar 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

Exportformaten

Download historische data voor offline analyse:

CSV — Standaard kolomformaat voor spreadsheets
JSON — Gestructureerd formaat met alle metadata
Parquet — Gecomprimeerd kolomformaat voor datawetenschap
HDF5 — Tijdreeks-geoptimaliseerd formaat

Export-query
// Exporteer als CSV
GET /v1/backtest/export?
  symbols=BTCUSDT&
  timeframe=1d&
  lookback=365d&
  format=csv

Praktische voorbeelden

Voorbeeld 1: Onderzoek Bull Market 2024

Bull Market-analyse
// Correlatie whale-beweging met prijsactie
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

Voorbeeld 2: Backtesten van Funding Rate Strategie

Strategie Backtest
// Haal data voor funding rate mean reversion strategie
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

Beste Praktijken voor Historische Data

1. Kies Geschikte Tijdframes

Gebruik het kleinste tijdframe dat nodig is voor je analyse. 1-minuut data is duurder dan uurlijkse data.

2. Specificeer Tijdsbereiken

Gebruik altijd start_time/end_time of lookback parameters. Open queries zijn inefficiënt.

3. Cache Historische Queries

Historische data is onveranderlijk. Cache agressief (30-dagen TTL voor maandelijkse data).

4. Gebruik Paginering voor Grote Resultaten

1-minuut data over 1 jaar = 525,600 candles. Gebruik paginering en streaming voor grote datasets.

5. Controleer Data Volledigheid

Controleer responsemetadata op hiaten of ontbrekende exchanges voordat je data in analyse gebruikt.

Toegang tot Historische Data voor Onderzoek

24 maanden aan OHLCV, whale movement en funding rate data. Perfect voor backtesting, onderzoek en strategieontwikkeling.

Bekijk Abonnementen

Gratis tier: 30d geschiedenis. Pro: 24 maanden. Enterprise: Volledige archieftoegang.