Índice

Visão Geral Velas OHLCV Opções de Período de Tempo Consultas Históricas Intervalos de Agregação Histórico de Movimentação de Baleias Histórico de Taxas de Funding Dados para Backtesting Exemplos de Uso Melhores Práticas

Documentação da API

Dados de Séries Temporais e Consultas de Análise Histórica

Acesse dados abrangentes de séries temporais para backtesting, pesquisa e análise histórica. Consulte velas OHLCV, taxas de funding históricas, cronogramas de movimentação de baleias e instantâneos de mercado agregados em múltiplos períodos de tempo.

Publicado em 21 de março de 2026 • 15 min de leitura • Pesquisa

Visão Geral de Dados Históricos

A Smart Money API fornece 24 meses de dados históricos, permitindo pesquisa abrangente, backtesting e análise baseada em tempo. Todos os dados históricos são normalizados, deduplicados e disponíveis em múltiplos níveis de agregação.

Dados históricos disponíveis incluem:

Velas OHLCV — Abertura, Máxima, Mínima, Fechamento, Volume para todos os pares negociados
Movimentações de Baleias — Acumulação/distribuição histórica em resolução diária e horária
Taxas de Funding — Instantâneos históricos de taxas de funding para todos os pares perpétuos
Open Interest — Dados históricos de OI em todas as exchanges e períodos de tempo
Liquidações — Cascatas de liquidação históricas e pontos de pressão

Retenção de Dados: Dados completos de tick retidos por 90 dias. Dados agregados horários/diários retidos por 24 meses. Arquivos brutos disponíveis para download.

Dados de Velas OHLCV

Dados de Abertura-Máxima-Mínima-Fechamento-Volume para análise técnica e gráficos. Disponível para todos os pares de criptomoedas em períodos de tempo de 1 minuto a 1 mês.

Estrutura de Dados OHLCV

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

Consultar Dados OHLCV

Consulta Histórica OHLCV
// Obter velas de 1 hora dos últimos 30 dias
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  lookback=30d&
  limit=720

Obtenha sua chave de API em 30 segundos

Pronto para construir? Obtenha uma chave de API gratuita (200 chamadas/dia, sem cartão) e comece a puxar dados ao vivo de baleias, funding e on-chain.

Obtenha sua chave de API →

Períodos de Tempo Disponíveis

Opções de Período de Tempo

Período de Tempo	Duração	Caso de Uso	Máximo de Lookback
1m	1 minuto	Negociação de alta frequência, scalping	30 dias
5m	5 minutos	Intraday, swing trading	90 dias
15m	15 minutos	Day trading, detecção de sinais	180 dias
1h	1 hora	Negociação de médio prazo, análise	365 dias
4h	4 horas	Swing trading, análise de tendência	24 meses
1d	1 dia	Posicionamento de longo prazo, pesquisa	24 meses
1w	1 semana	Análise macro, tendências plurianuais	24 meses
1M	1 mês	Posicionamento estratégico	24 meses

Combinações de Períodos de Tempo

Consulte múltiplos períodos de tempo simultaneamente:

Consulta Multi-Período de Tempo
GET /v1/historical/ohlcv/multi?
  symbol=BTCUSDT&
  timeframes=1h,4h,1d&
  timestamp=1709980800000
// Retorna a última vela para cada período de tempo

Padrões de Consulta Histórica

Consultas Baseadas em Tempo

Consulta por Intervalo de Tempo
// Consultar intervalo de tempo específico
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  start_time=1709894400000&
  end_time=1709980800000
// Ou use lookback relativo
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1d&
  lookback=90d

Paginação para Grandes Conjuntos de Dados

Padrão de Paginação
// Primeira página: 1000 candles
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  limit=1000&
  start_time=1709980800000
// Próxima página usando cursor
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  cursor=1709981000000&
  limit=1000

Intervalos de Agregação

Agregação em Tempo Fixo

Agregar dados em intervalos fixos (horários, diários, semanais):

Agregação Fixa
// Snapshots diários por 1 mês
GET /v1/historical/snapshots?
  metrics=whale_net_flow,funding_rate,oi&
  interval=1d&
  lookback=30d

Agregação Personalizada

Agregar em janelas de tempo personalizadas:

Janelas Personalizadas
// Agregar candles de 1 minuto em 15m
GET /v1/historical/ohlcv/resample?
  symbol=BTCUSDT&
  source_timeframe=1m&
  target_timeframe=15m&
  lookback=7d

Histórico de Movimentação de Baleias

Rastreamento Histórico de Baleias

Histórico de Baleias
// Padrões históricos de acumulação de baleias
GET /v1/historical/whales?
  asset=BTC&
  metric=net_accumulation&
  interval=1d&
  lookback=365d
// Movimentação histórica em torno de níveis de preço
GET /v1/historical/whales/price-correlation?
  asset=ETH&
  lookback=90d

Estrutura de Dados de Baleias

Ponto de Dados de Baleias
{
 "timestamp": 1709980800000,
 "asset": "BTC",
 "metric": "net_accumulation",
 "value": 50000,  // BTC
 "whale_count": 847,
 "exchange_inflow": -12000,
 "exchange_outflow": 62000
}

Histórico de Taxa de Funding

Snapshots Históricos de Taxa de Funding

Histórico de Taxa de Funding
// Obter snapshots horários de taxa de funding
GET /v1/historical/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance&
  interval=1h&
  lookback=30d
// Comparar taxas históricas entre exchanges
GET /v1/historical/derivatives/funding-heatmap/comparative?
  symbol=ETHUSDT&
  exchanges=bybit,binance,hyperliquid&
  interval=4h&
  lookback=90d

Estatísticas de Taxa de Funding

Consultar estatísticas agregadas de taxa de funding:

Consulta de Estatísticas
GET /v1/historical/derivatives/funding-stats?
  symbol=BTCUSDT&
  lookback=365d&
  metrics=mean,median,std_dev,min,max
// Resposta inclui:
// - Média anual da taxa de funding
// - Distribuição (desvio padrão)
// - Extremos históricos
// - Rank de percentis

Acesso a Dados para Backtesting

Formato de Consulta para Backtesting

Otimizado para frameworks de backtesting como Backtrader, VectorBT e motores personalizados:

Dados para Backtest
// Obter todos os dados para backtest de 1 ano
GET /v1/backtest/data?
  symbols=BTCUSDT,ETHUSDT&
  timeframe=1h&
  start=2024-01-01&
  end=2025-01-01&
  fields=ohlcv,funding_rate,oi,whale_flow

Formatos de Exportação

Baixar dados históricos para análise offline:

CSV — Formato colunar padrão para planilhas
JSON — Formato estruturado com todos os metadados
Parquet — Formato colunar compactado para ciência de dados
HDF5 — Formato otimizado para séries temporais

Consulta de Exportação
// Exportar como CSV
GET /v1/backtest/export?
  symbols=BTCUSDT&
  timeframe=1d&
  lookback=365d&
  format=csv

Exemplos Práticos

Exemplo 1: Pesquisa sobre o Mercado em Alta de 2024

Análise de Mercado em Alta
// Correlacionar movimentação de baleias com ação de preço
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

Exemplo 2: Backtest de Estratégia com Taxa de Funding

Backtest de Estratégia
// Obter dados para estratégia de reversão à média da taxa de funding
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

Melhores Práticas com Dados Históricos

1. Escolha Períodos de Tempo Adequados

Use o menor período de tempo necessário para sua análise. Dados de 1 minuto são mais caros que dados horários.

2. Especifique Intervalos de Tempo

Sempre use parâmetros start_time/end_time ou lookback. Consultas sem limites são ineficientes.

3. Armazene em Cache Consultas Históricas

Dados históricos são imutáveis. Armazene em cache agressivamente (TTL de 30 dias para dados mensais).

4. Use Paginação para Resultados Grandes

Dados de 1 minuto ao longo de 1 ano = 525.600 candles. Use paginação e streaming para conjuntos grandes.

5. Valide a Integridade dos Dados

Verifique os metadados da resposta para lacunas ou exchanges ausentes antes de usar os dados na análise.

Acesse Dados Históricos para Pesquisa

24 meses de dados OHLCV, movimentação de baleias e taxa de funding. Perfeito para backtest, pesquisa e desenvolvimento de estratégias.

Ver Planos

Plano gratuito: histórico de 30d. Pro: 24 meses. Enterprise: Acesso completo ao arquivo.