Tabla de Contenidos

Resumen Velas OHLCV Opciones de Marco Temporal Consultas Históricas Intervalos de Agregación Historial de Movimientos de Ballenas Historial de Tasas de Financiamiento Datos para Backtesting Ejemplos de Uso Mejores Prácticas

Documentación de la API

Datos de Series Temporales y Consultas de Análisis Histórico

Accede a datos de series temporales completos para backtesting, investigación y análisis histórico. Consulta velas OHLCV, tasas de financiamiento históricas, cronologías de movimientos de ballenas y instantáneas de mercado agregadas en múltiples marcos temporales.

Publicado el 21 de marzo de 2026 • 15 min de lectura • Investigación

Resumen de Datos Históricos

Smart Money API proporciona 24 meses de datos históricos que permiten una investigación exhaustiva, backtesting y análisis basado en el tiempo. Todos los datos históricos están normalizados, sin duplicados y disponibles en múltiples niveles de agregación.

Los datos históricos disponibles incluyen:

Velas OHLCV — Apertura, Máximo, Mínimo, Cierre, Volumen para todos los pares negociados
Movimientos de Ballenas — Acumulación/distribución histórica con resolución diaria y horaria
Tasas de Financiamiento — Instantáneas históricas de tasas de financiamiento para todos los pares perpetuos
Interés Abierto — Datos históricos de OI en todos los exchanges y marcos temporales
Liquidaciones — Cascadas de liquidación históricas y puntos de presión

Retención de Datos: Datos de tick completos retenidos por 90 días. Datos agregados horarios/diarios retenidos por 24 meses. Archivos brutos disponibles para descarga.

Datos de Velas OHLCV

Datos de Apertura-Máximo-Mínimo-Cierre-Volumen para análisis técnico y gráficos. Disponibles para todos los pares de criptomonedas en marcos temporales desde 1 minuto hasta 1 mes.

Estructura de Datos 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 Datos OHLCV

Consulta Histórica OHLCV
// Obtener velas de 1 hora para los últimos 30 días
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  lookback=30d&
  limit=720

Obtén tu clave API en 30 segundos

¿Listo para construir? Consigue una clave API gratuita (200 llamadas/día, sin tarjeta) y comienza a obtener datos en vivo de ballenas, financiamiento y on-chain.

Obtén tu clave API →

Marcos Temporales Disponibles

Opciones de Marco Temporal

Marco Temporal	Duración	Caso de Uso	Máximo Lookback
1m	1 minuto	Trading de alta frecuencia, scalping	30 días
5m	5 minutos	Intradía, swing trading	90 días
15m	15 minutos	Day trading, detección de señales	180 días
1h	1 hora	Trading a medio plazo, análisis	365 días
4h	4 horas	Swing trading, análisis de tendencias	24 meses
1d	1 día	Posicionamiento a largo plazo, investigación	24 meses
1w	1 semana	Análisis macro, tendencias plurianuales	24 meses
1M	1 mes	Posicionamiento estratégico	24 meses

Combinaciones de Marcos Temporales

Consulta múltiples marcos temporales simultáneamente:

Consulta Multi-Marco Temporal
GET /v1/historical/ohlcv/multi?
  symbol=BTCUSDT&
  timeframes=1h,4h,1d&
  timestamp=1709980800000
// Devuelve la última vela para cada marco temporal

Patrones de Consulta Histórica

Consultas Basadas en Tiempo

Consulta por Rango de Tiempo
// Consulta un rango de tiempo específico
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  start_time=1709894400000&
  end_time=1709980800000
// O usa lookback relativo
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1d&
  lookback=90d

Paginación para grandes conjuntos de datos

Patrón de paginación
// Primera página: 1000 velas
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  limit=1000&
  start_time=1709980800000
// Página siguiente usando cursor
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  cursor=1709981000000&
  limit=1000

Intervalos de agregación

Agregación de tiempo fijo

Agregar datos en intervalos fijos (horarios, diarios, semanales):

Agregación fija
// Instantáneas diarias durante 1 mes
GET /v1/historical/snapshots?
  metrics=whale_net_flow,funding_rate,oi&
  interval=1d&
  lookback=30d

Agregación personalizada

Agregar en ventanas de tiempo personalizadas:

Ventanas personalizadas
// Agregar velas de 1 minuto en 15m
GET /v1/historical/ohlcv/resample?
  symbol=BTCUSDT&
  source_timeframe=1m&
  target_timeframe=15m&
  lookback=7d

Historial de movimientos de ballenas

Seguimiento histórico de ballenas

Historial de ballenas
// Patrones históricos de acumulación de ballenas
GET /v1/historical/whales?
  asset=BTC&
  metric=net_accumulation&
  interval=1d&
  lookback=365d
// Movimiento histórico alrededor de niveles de precio
GET /v1/historical/whales/price-correlation?
  asset=ETH&
  lookback=90d

Estructura de datos de ballenas

Punto de datos de ballena
{
 "timestamp": 1709980800000,
 "asset": "BTC",
 "metric": "net_accumulation",
 "value": 50000,  // BTC
 "whale_count": 847,
 "exchange_inflow": -12000,
 "exchange_outflow": 62000
}

Historial de tasas de financiamiento

Instantáneas históricas de tasas de financiamiento

Historial de tasas de financiamiento
// Obtener instantáneas horarias de tasas de financiamiento
GET /v1/historical/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance&
  interval=1h&
  lookback=30d
// Comparar tasas históricas entre exchanges
GET /v1/historical/derivatives/funding-heatmap/comparative?
  symbol=ETHUSDT&
  exchanges=bybit,binance,hyperliquid&
  interval=4h&
  lookback=90d

Estadísticas de tasas de financiamiento

Consultar estadísticas agregadas de tasas de financiamiento:

Consulta de estadísticas
GET /v1/historical/derivatives/funding-stats?
  symbol=BTCUSDT&
  lookback=365d&
  metrics=mean,median,std_dev,min,max
// La respuesta incluye:
// - Promedio anual de tasa de financiamiento
// - Distribución (desviación estándar)
// - Extremos históricos
// - Rangos percentiles

Acceso a datos para backtesting

Formato de consulta para backtesting

Optimizado para frameworks de backtesting como Backtrader, VectorBT y motores personalizados:

Datos para backtesting
// Obtener todos los datos para backtesting de 1 año
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 exportación

Descargar datos históricos para análisis sin conexión:

CSV — Formato columnar estándar para hojas de cálculo
JSON — Formato estructurado con todos los metadatos
Parquet — Formato columnar comprimido para ciencia de datos
HDF5 — Formato optimizado para series temporales

Consulta de exportación
// Exportar como CSV
GET /v1/backtest/export?
  symbols=BTCUSDT&
  timeframe=1d&
  lookback=365d&
  format=csv

Ejemplos prácticos

Ejemplo 1: Investigar el mercado alcista de 2024

Análisis de mercado alcista
// Correlacionar movimiento de ballenas con acción de precios
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

Ejemplo 2: Prueba retrospectiva de estrategia de tasa de financiación

Prueba Retrospectiva de Estrategia
// Obtener datos para la estrategia de reversión a la media de la tasa de financiación
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

Mejores Prácticas para Datos Históricos

1. Elige Marcos de Tiempo Apropiados

Usa el marco de tiempo más pequeño necesario para tu análisis. Los datos de 1 minuto son más costosos que los datos por hora.

2. Especifica Rangos de Tiempo

Siempre usa start_time/end_time o parámetros de lookback. Las consultas abiertas son ineficientes.

3. Almacena en Caché las Consultas Históricas

Los datos históricos son inmutables. Almacena en caché agresivamente (TTL de 30 días para datos mensuales).

4. Usa Paginación para Resultados Grandes

Datos de 1 minuto durante 1 año = 525,600 velas. Usa paginación y streaming para conjuntos de datos grandes.

5. Valida la Integridad de los Datos

Verifica los metadatos de respuesta para detectar huecos o intercambios faltantes antes de usar los datos en el análisis.

Accede a Datos Históricos para Investigación

24 meses de datos OHLCV, movimiento de ballenas y tasa de financiación. Perfecto para pruebas retrospectivas, investigación y desarrollo de estrategias.

Ver Planes

Nivel gratuito: 30d de historial. Pro: 24 meses. Enterprise: Acceso completo al archivo.