Índice

Visão Geral Exchanges Suportadas Conceitos de Fusão de Dados Filtragem Básica Filtros Avançados Ordenação e Classificação Agregação de Dados Normalização de Dados Exemplos de Consulta Dicas de Desempenho

Documentação da API

Agregação de Dados Multi-Exchange e Filtragem Avançada

Domine a agregação de dados entre Bybit, Binance e Hyperliquid com filtragem avançada, ordenação e normalização. Obtenha insights unificados de mercado de 3+ exchanges simultaneamente.

Publicado em 21 de março de 2026 • 17 min de leitura • Avançado

Visão Geral da Agregação de Dados

A Smart Money API agrega dados de derivativos de criptomoedas de 3 grandes exchanges: Bybit, Binance e Hyperliquid. Em vez de fazer chamadas de API separadas para cada exchange, você obtém dados unificados com filtragem inteligente, comparação entre exchanges e capacidades analíticas avançadas.

Por que a agregação é importante:

Única Chamada de API — Obtenha dados de 3 exchanges simultaneamente sem gerenciar múltiplas conexões
Formato Normalizado — Todas as exchanges padronizadas em um esquema consistente
Insights Entre Exchanges — Compare taxas de funding, posições e liquidez entre plataformas
Filtragem Inteligente — Consulte exatamente os dados que você precisa com filtros poderosos
Desempenho — Respostas agregadas em cache CDN 50x mais rápidas do que agregar você mesmo

Arquitetura: A Smart Money API coleta dados das exchanges a cada 1-5 segundos, normaliza, armazena em cache na borda da CDN e fornece respostas agregadas com latência inferior a 100ms globalmente.

Exchanges Suportadas

Bybit

Código: bybit | Cobertura: 500+ pares perpétuos | Frequência de Atualização: 1 segundo

Futuros perpétuos USDT (contratos lineares)
Perpétuos inversos (XRP, ETC)
Dados completos de livro de ordens e trades
Taxas de funding e preços de mark

Binance

Código: binance | Cobertura: 800+ pares perpétuos | Frequência de Atualização: 1 segundo

Futuros USDT-M (perpétuos USDT)
Futuros COIN-M (inversos)
Dados completos de microestrutura de mercado
Maior liquidez entre pares

Hyperliquid

Código: hyperliquid | Cobertura: 300+ pares perpétuos | Frequência de Atualização: 5 segundos

Futuros perpétuos descentralizados (sem margem)
Modelo de liquidação on-chain único
Integração nativa de dados de carteiras de baleias
Menor latência para traders algorítmicos

Tabela de Especificações das Exchanges

Exchange	Pares	Alavancagem	Freq. Atualização	Liquidação
bybit	500+	1-125x	1s	Perpétuo
binance	800+	1-125x	1s	Perpétuo
hyperliquid	300+	1-20x	5s	Perpétuo

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 de baleias, funding e on-chain em tempo real.

Obtenha sua chave de API →

Conceitos de Fusão de Dados

Normalização

Cada exchange tem nomes de campos, precisão decimal e estruturas de dados diferentes. A Smart Money normaliza tudo para um esquema padrão:

Resposta Normalizada
{
 "exchange": "bybit",
 "symbol": "BTCUSDT",
 "funding_rate": 0.0001,
 "mark_price": 72500.50,
 "index_price": 72480.25,
 "open_interest": 850000000,
 "timestamp": 1709980800000
}

Alinhamento de Timestamp

Todos os pontos de dados são timestampados e alinhados em milissegundos UTC. Dados antigos são tratados de forma transparente:

Dados em tempo real: coletados nos últimos 5 segundos
Dados envelhecidos: marcados com age_ms indicando obsolescência
Exchanges ausentes: retorna resultados parciais com lista de exchanges
Dados obsoletos completos: retorna resultado em cache com cache_age_seconds

Metadados Entre Exchanges

Toda resposta agregada inclui metadados sobre as fontes de dados:

Metadados de Agregação
{
 "data": [...],
 "_meta": {
 "exchanges": ["bybit", "binance", "hyperliquid"],
 "count": 245,
 "aggregated_at": 1709980800123,
 "sources_healthy": true
  }
}

Filtragem Básica

Filtrar por Exchange

Solicitar dados apenas de exchanges específicas:

Filtro de Exchange Única
// Obter taxas de financiamento apenas da Binance
GET /v1/derivatives/funding-heatmap?exchange=binance
// Múltiplas exchanges
GET /v1/derivatives/funding-heatmap?exchange=bybit,binance

Filtrar por Classe de Ativo

Filtrar por criptomoeda ou par de negociação:

Filtro de Ativo
// Apenas pares de Bitcoin
GET /v1/derivatives/funding-heatmap?asset=BTC
// Múltiplos ativos
GET /v1/derivatives/funding-heatmap?asset=BTC,ETH,SOL
// Pares específicos
GET /v1/derivatives/funding-heatmap?symbol=BTCUSDT,ETHUSDT

Filtrar por Intervalo de Métrica

Consultar com base em valores numéricos:

Filtros de Intervalo
// Taxas de financiamento altas (>0,01%)
GET /v1/derivatives/funding-heatmap?funding_rate_min=0.0001
// Taxas de financiamento baixas (<-0,01%)
GET /v1/derivatives/funding-heatmap?funding_rate_max=-0.0001
// Alto interesse aberto
GET /v1/derivatives/oi-rankings?oi_min=100000000

Filtragem Avançada

Filtros Comparativos

Encontrar pares com características específicas entre exchanges:

Consultas Comparativas
// Pares com diferença de financiamento >5% entre exchanges
GET /v1/derivatives/comparative?metric=funding_rate_spread&min=0.0005
// Divergência de liquidação
GET /v1/derivatives/comparative?metric=liquidation_pressure_diff
// Pares com maior razão de interesse aberto Bybit/Binance
GET /v1/derivatives/comparative?metric=oi_ratio&base=bybit&compare=binance&min=1.5

Filtros Baseados em Tempo

Consultar dados históricos agregados:

Filtros de Tempo
// Dados de um período específico
GET /v1/derivatives/funding-heatmap?start_time=1709980800&end_time=1709984400
// Últimas 24 horas
GET /v1/derivatives/funding-heatmap?lookback=24h
// Instantâneos em intervalos de 1 hora
GET /v1/derivatives/historical?interval=1h&limit=24

Filtros Compostos

Combinar múltiplas condições de filtro:

Consulta Complexa
// Pares de topo: BTC, ETH, SOL
// Financiamento alto positivo na Binance
// Financiamento negativo na Bybit (arbitragem)
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

Ordenação e Classificação

Direções de Ordenação

Controlar a ordenação dos resultados:

Exemplos de Ordenação
// Maiores taxas de financiamento primeiro
GET /v1/derivatives/funding-heatmap?sort=funding_rate:desc
// Menor interesse aberto
GET /v1/derivatives/oi-rankings?sort=open_interest:asc
// Carimbo de data/hora mais recente
GET /v1/derivatives/funding-heatmap?sort=timestamp:desc
// Ordenação multi-campo
GET /v1/derivatives?sort=exchange:asc,funding_rate:desc

Opções de Classificação

Campo	Descrição	Intervalo
funding_rate	Taxa de financiamento de contrato perpétuo	-1.0 a 1.0
open_interest	Total de posições abertas em USD	0 a bilhões
mark_price	Preço de marcação/liquidação do contrato	Positivo
liquidation_pressure	Risco de liquidação de longs vs shorts	-1.0 a 1.0

Modos de Agregação de Dados

Agregação Bruta

Retornar todos os pontos de dados separadamente com identificação da fonte da exchange:

Modo Bruto
GET /v1/derivatives/funding-heatmap?aggregate_mode=raw&symbol=BTCUSDT
// Resposta: 3 entradas separadas (uma por exchange)
[
  { exchange: "bybit", funding_rate: 0.00010 },
  { exchange: "binance", funding_rate: 0.00012 },
  { exchange: "hyperliquid", funding_rate: 0.00009 }
]

Agregação Mesclada

Combinar dados em um único registro com campos estatísticos:

Modo Mesclado
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 }
}

Agregação Composta

Agregação estatística com pontuações de confiança:

Modo Composto
GET /v1/derivatives/funding-heatmap?aggregate_mode=composite&symbol=BTCUSDT
{
  symbol: "BTCUSDT",
  funding_rate_consensus: 0.000103,
  confidence_score: 0.98,  // 98% de concordância
  outliers: [],
  weighted_avg: 0.000102,  // média ponderada por liquidez
  exchange_details: { ... }
}

Normalização de Dados

Normalização de Preço

Todos os preços são normalizados para 8 casas decimais e denominação em USDT:

Bybit: pares USDT normalizados diretamente
Binance: USDT-M e COIN-M convertidos para o formato padrão
Hyperliquid: USDT nativo convertido consistentemente

Normalização de Volume

Todos os volumes reportados em unidades do ativo base:

Campos de Volume
{
 "volume_base": 1234.5,  // BTC
 "volume_quote": 89234500,  // USDT
 "num_trades": 45678
}

Normalização de Timestamp

Todos os timestamps em milissegundos UTC (13 dígitos)
Sincronizado com o relógio do gateway da API
Ajuste de idade para dados coletados em momentos diferentes
Agnóstico de fuso horário (sempre UTC)

Exemplos Práticos de Consulta

Exemplo 1: Oportunidades de Arbitragem de Taxa de Funding

Encontre pares com maior spread entre funding longo na Binance e funding curto na Bybit:

Consulta de Arbitragem
GET /v1/derivatives/funding-heatmap?
  exchange=bybit,binance&
  asset=BTC,ETH,SOL,ARB&
  sort=funding_rate_spread:desc&
  limit=10&
  aggregate_mode=merged

Exemplo 2: Contratos com Alto Open Interest

Obtenha contratos com open interest significativo em todas as exchanges:

Consulta de Liquidez
GET /v1/derivatives/oi-rankings?
  oi_min=100000000&
  sort=open_interest:desc&
  limit=20&
  aggregate_mode=merged

Exemplo 3: Agregação de Séries Temporais

Taxas de funding históricas em intervalos de 4 horas:

Agregação Histórica
GET /v1/historical/funding?
  symbol=BTCUSDT&
  interval=4h&
  limit=30&
  aggregate_mode=composite

Dicas de Performance

1. Use Filtros Específicos

Quanto mais específica sua consulta, mais rápida a resposta. Filtrar 800 pares para 5 retorna mais rápido do que solicitar todos.

2. Limite o Conjunto de Resultados

Sempre especifique um parâmetro de limite. O padrão é 100; o máximo é 1000. Conjuntos grandes de resultados são mais lentos e consomem mais banda.

3. Escolha o Modo de Agregação

Os modos merged e composite são mais rápidos que o modo raw para pequenos conjuntos de dados. O modo raw é melhor para análise detalhada de exchanges individuais.

4. Faça Cache Agressivamente

Essas respostas têm tempos de vida de cache previsíveis. Implemente cache local para evitar solicitações redundantes.

5. Use Intervalos de Tempo Específicos

Consultas históricas com janelas de tempo estreitas são muito mais rápidas do que parâmetros de lookback abertos.

Domine Dados Multi-Exchange

Obtenha dados unificados de derivativos da Bybit, Binance e Hyperliquid com filtros poderosos, agregação e normalização. Economize tempo de engenharia e reduza custos de API.

Ver Planos

O plano gratuito inclui agregação básica. Os planos Trader e Pro desbloqueiam filtros avançados e consultas históricas.