Documentación de la API
Agregación de Datos Multi-Exchange y Filtrado Avanzado
Domina la agregación de datos en Bybit, Binance e Hyperliquid con filtrado avanzado, ordenamiento y normalización. Obtén información de mercado unificada de 3+ exchanges simultáneamente.
Publicado el 21 de marzo de 2026
•
17 min de lectura
•
Avanzado
Resumen de Agregación de Datos
La API Smart Money agrega datos de derivados de criptomonedas de 3 exchanges principales: Bybit, Binance e Hyperliquid. En lugar de hacer llamadas API separadas a cada exchange, obtienes datos unificados con filtrado inteligente, comparación entre exchanges y capacidades analíticas avanzadas.
Por qué es importante la agregación:
- Una sola llamada API — Obtén datos de 3 exchanges simultáneamente sin gestionar múltiples conexiones
- Formato Normalizado — Todos los exchanges estandarizados a un esquema consistente
- Información entre Exchanges — Compara tasas de financiamiento, posiciones y liquidez entre plataformas
- Filtrado Inteligente — Consulta los datos exactos que necesitas con filtros potentes
- Rendimiento — Respuestas agregadas en caché por CDN 50 veces más rápido que si lo hicieras tú mismo
Arquitectura: La API Smart Money recopila datos de los exchanges cada 1-5 segundos, los normaliza, los almacena en caché en el borde de la CDN y sirve respuestas agregadas con una latencia inferior a 100 ms a nivel global.
Exchanges Soportados
Bybit
Código: bybit | Cobertura: 500+ pares perpetuos | Frecuencia de Actualización: 1 segundo
- Futuros perpetuos USDT (contratos lineales)
- Perpetuos inversos (XRP, ETC)
- Datos completos de libro de órdenes y operaciones
- Tasas de financiamiento y precios de marca
Binance
Código: binance | Cobertura: 800+ pares perpetuos | Frecuencia de Actualización: 1 segundo
- Futuros USDT-M (perpetuos USDT)
- Futuros COIN-M (inversos)
- Datos completos de microestructura de mercado
- Mayor liquidez entre pares
Hyperliquid
Código: hyperliquid | Cobertura: 300+ pares perpetuos | Frecuencia de Actualización: 5 segundos
- Futuros perpetuos descentralizados (sin margen)
- Modelo de liquidación on-chain único
- Integración de datos de billeteras de ballenas nativas
- Menor latencia para traders algorítmicos
Tabla de Especificaciones de Exchanges
| Exchange |
Pares |
Apalancamiento |
Frec. Actualización |
Liquidación |
| bybit |
500+ |
1-125x |
1s |
Perpetuo |
| binance |
800+ |
1-125x |
1s |
Perpetuo |
| hyperliquid |
300+ |
1-20x |
5s |
Perpetuo |
Obtén tu clave API en 30 segundos
¿Listo para construir? Obtén 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 →
Conceptos de Fusión de Datos
Normalización
Cada exchange tiene diferentes nombres de campos, precisión decimal y estructuras de datos. Smart Money normaliza todo a un esquema estándar:
{
"exchange": "bybit",
"symbol": "BTCUSDT",
"funding_rate": 0.0001,
"mark_price": 72500.50,
"index_price": 72480.25,
"open_interest": 850000000,
"timestamp": 1709980800000
}
Alineación de Marcas de Tiempo
Todos los puntos de datos tienen marca de tiempo y están alineados a UTC en milisegundos. Los datos antiguos se manejan de forma transparente:
- Datos en tiempo real: obtenidos en los últimos 5 segundos
- Datos envejecidos: marcados con age_ms indicando antigüedad
- Exchanges faltantes: devuelve resultados parciales con lista de exchanges
- Datos obsoletos completos: devuelve resultado en caché con cache_age_seconds
Metadatos entre Exchanges
Cada respuesta agregada incluye metadatos sobre las fuentes de datos:
{
"data": [...],
"_meta": {
"exchanges": ["bybit", "binance", "hyperliquid"],
"count": 245,
"aggregated_at": 1709980800123,
"sources_healthy": true
}
}
Filtrado Básico
Filtrar por Exchange
Solicitar datos solo de exchanges específicos:
// Obtener tasas de funding solo de Binance
GET /v1/derivatives/funding-heatmap?exchange=binance
// Múltiples exchanges
GET /v1/derivatives/funding-heatmap?exchange=bybit,binance
Filtrar por Clase de Activo
Filtrar por criptomoneda o par de trading:
// Solo pares de Bitcoin
GET /v1/derivatives/funding-heatmap?asset=BTC
// Múltiples activos
GET /v1/derivatives/funding-heatmap?asset=BTC,ETH,SOL
// Pares específicos
GET /v1/derivatives/funding-heatmap?symbol=BTCUSDT,ETHUSDT
Filtrar por Rango de Métrica
Consultar basado en valores numéricos:
// Tasas de funding altas (>0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_min=0.0001
// Tasas de funding bajas (<-0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_max=-0.0001
// Interés abierto alto
GET /v1/derivatives/oi-rankings?oi_min=100000000
Filtrado Avanzado
Filtros Comparativos
Encontrar pares con características específicas entre exchanges:
// Pares con diferencia de funding >5% entre exchanges
GET /v1/derivatives/comparative?metric=funding_rate_spread&min=0.0005
// Divergencia de liquidaciones
GET /v1/derivatives/comparative?metric=liquidation_pressure_diff
// Pares con mayor ratio de interés abierto Bybit/Binance
GET /v1/derivatives/comparative?metric=oi_ratio&base=bybit&compare=binance&min=1.5
Filtros Basados en Tiempo
Consultar datos históricos agregados:
// Datos de una ventana de tiempo específica
GET /v1/derivatives/funding-heatmap?start_time=1709980800&end_time=1709984400
// Últimas 24 horas
GET /v1/derivatives/funding-heatmap?lookback=24h
// Instantáneas en intervalos de 1 hora
GET /v1/derivatives/historical?interval=1h&limit=24
Filtros Compuestos
Combinar múltiples condiciones de filtrado:
// Pares de primer nivel: BTC, ETH, SOL
// Funding positivo alto en Binance
// Funding negativo en Bybit (arbitraje)
GET /v1/derivatives/funding-heatmap?
asset=BTC,ETH,SOL&
exchange=binance,bybit&
binance_funding_rate_min=0.0003&
bybit_funding_rate_max=-0.0001&
sort=funding_rate_spread:desc
Ordenación y Clasificación
Direcciones de Ordenación
Controlar el orden de los resultados:
// Tasas de funding más altas primero
GET /v1/derivatives/funding-heatmap?sort=funding_rate:desc
// Interés abierto más bajo
GET /v1/derivatives/oi-rankings?sort=open_interest:asc
// Marca de tiempo más reciente
GET /v1/derivatives/funding-heatmap?sort=timestamp:desc
// Ordenación multi-campo
GET /v1/derivatives?sort=exchange:asc,funding_rate:desc
Opciones de Clasificación
| Campo |
Descripción |
Rango |
| funding_rate |
Tasa de funding de contratos perpetuos |
-1.0 a 1.0 |
| open_interest |
Posiciones abiertas totales en USD |
0 a miles de millones |
| mark_price |
Precio de marca/liquidación del contrato |
Positivo |
| liquidation_pressure |
Riesgo de liquidación longs vs shorts |
-1.0 a 1.0 |
Modos de Agregación de Datos
Agregación en Bruto
Devolver todos los puntos de datos por separado con identificación de origen del exchange:
GET /v1/derivatives/funding-heatmap?aggregate_mode=raw&symbol=BTCUSDT
// Respuesta: 3 entradas separadas (una por exchange)
[
{ exchange: "bybit", funding_rate: 0.00010 },
{ exchange: "binance", funding_rate: 0.00012 },
{ exchange: "hyperliquid", funding_rate: 0.00009 }
]
Agregación Combinada
Combinar datos en un único registro con campos estadísticos:
GET /v1/derivatives/funding-heatmap?aggregate_mode=merged&symbol=BTCUSDT
{
symbol: "BTCUSDT",
funding_rate_avg: 0.000103,
funding_rate_median: 0.00010,
funding_rate_min: 0.00009,
funding_rate_max: 0.00012,
funding_rate_spread: 0.00003,
sources: { bybit, binance, hyperliquid }
}
Agregación Compuesta
Agregación estadística con puntuaciones de confianza:
GET /v1/derivatives/funding-heatmap?aggregate_mode=composite&symbol=BTCUSDT
{
symbol: "BTCUSDT",
funding_rate_consensus: 0.000103,
confidence_score: 0.98, // 98% de acuerdo
outliers: [],
weighted_avg: 0.000102, // promedio ponderado por liquidez
exchange_details: { ... }
}
Normalización de Datos
Normalización de Precios
Todos los precios se normalizan a 8 decimales y denominación USDT:
- Bybit: pares USDT normalizados directamente
- Binance: USDT-M y COIN-M convertidos a forma estándar
- Hyperliquid: USDT nativo convertido consistentemente
Normalización de volumen
Todos los volúmenes reportados en unidades del activo base:
{
"volume_base": 1234.5,
"volume_quote": 89234500,
"num_trades": 45678
}
Normalización de marca de tiempo
- Todas las marcas de tiempo en milisegundos UTC (13 dígitos)
- Sincronizado con el reloj de la API gateway
- Ajuste de edad para datos recolectados en diferentes momentos
- Independiente de zona horaria (siempre UTC)
Ejemplos prácticos de consultas
Ejemplo 1: Oportunidades de arbitraje de tasa de financiamiento
Encuentra pares con mayor diferencial entre financiamiento largo en Binance y corto en Bybit:
GET /v1/derivatives/funding-heatmap?
exchange=bybit,binance&
asset=BTC,ETH,SOL,ARB&
sort=funding_rate_spread:desc&
limit=10&
aggregate_mode=merged
Ejemplo 2: Contratos con alto interés abierto
Obtén contratos con interés abierto significativo en todos los exchanges:
GET /v1/derivatives/oi-rankings?
oi_min=100000000&
sort=open_interest:desc&
limit=20&
aggregate_mode=merged
Ejemplo 3: Agregación de series temporales
Tasas de financiamiento históricas en intervalos de 4 horas:
GET /v1/historical/funding?
symbol=BTCUSDT&
interval=4h&
limit=30&
aggregate_mode=composite
Domina los datos multi-exchange
Obtén datos unificados de derivados de Bybit, Binance y Hyperliquid con filtrado, agregación y normalización potentes. Ahorra tiempo de ingeniería y reduce costos de API.
Ver planes
El nivel gratuito incluye agregación básica. Los planes Trader y Pro desbloquean filtrado avanzado y consultas históricas.