Indice

Panoramica Exchange Supportati Concetti di Fusione dei Dati Filtri di Base Filtri Avanzati Ordinamento e Classifica Aggregazione dei Dati Normalizzazione dei Dati Esempi di Query Suggerimenti sulle Prestazioni

Documentazione API

Aggregazione di Dati Multi-Exchange e Filtri Avanzati

Masterizza l'aggregazione dei dati attraverso Bybit, Binance e Hyperliquid con filtri avanzati, ordinamento e normalizzazione. Ottieni insight di mercato unificati da 3+ exchange contemporaneamente.

Pubblicato il 21 marzo 2026 • 17 min di lettura • Avanzato

Panoramica sull'Aggregazione dei Dati

La Smart Money API aggrega i dati dei derivati di criptovalute da 3 exchange principali: Bybit, Binance e Hyperliquid. Invece di effettuare chiamate API separate a ciascun exchange, ottieni dati unificati con filtri intelligenti, confronti cross-exchange e capacità analitiche avanzate.

Perché l'aggregazione è importante:

Singola Chiamata API — Ottieni dati da 3 exchange contemporaneamente senza gestire più connessioni
Formato Normalizzato — Tutti gli exchange standardizzati su uno schema coerente
Insight Cross-Exchange — Confronta tassi di finanziamento, posizioni e liquidità tra i vari exchange
Filtri Intelligenti — Interroga i dati esatti di cui hai bisogno con filtri potenti
Prestazioni — Risposte aggregate memorizzate nella CDN 50 volte più veloci rispetto all'aggregazione manuale

Architettura: La Smart Money API raccoglie dati dagli exchange ogni 1-5 secondi, li normalizza, li memorizza nella cache della CDN e fornisce risposte aggregate con una latenza inferiore a 100 ms a livello globale.

Exchange Supportati

Bybit

Codice: bybit | Copertura: 500+ coppie perpetue | Frequenza di Aggiornamento: 1 secondo

Futures perpetui USDT (contratti lineari)
Perpetui inversi (XRP, ETC)
Dati completi dell'order book e delle transazioni
Tassi di finanziamento e prezzi mark

Binance

Codice: binance | Copertura: 800+ coppie perpetue | Frequenza di Aggiornamento: 1 secondo

Futures USDT-M (perpetui USDT)
Futures COIN-M (inversi)
Dati completi della microstruttura del mercato
Liquidità più alta tra le coppie

Hyperliquid

Codice: hyperliquid | Copertura: 300+ coppie perpetue | Frequenza di Aggiornamento: 5 secondi

Futures perpetui decentralizzati (senza margine)
Modello di regolamento on-chain unico
Integrazione dei dati dei portafogli whale nativi
Latenza inferiore per i trader algoritmici

Tabella delle Specifiche degli Exchange

Exchange	Coppie	Leva	Freq Aggiornamento	Regolamento
bybit	500+	1-125x	1s	Perpetuo
binance	800+	1-125x	1s	Perpetuo
hyperliquid	300+	1-20x	5s	Perpetuo

Ottieni la tua chiave API in 30 secondi

Pronto a costruire? Prendi una chiave API gratuita (200 chiamate/giorno, nessuna carta) e inizia a estrarre dati live su whale, finanziamenti e on-chain.

Ottieni la tua chiave API →

Concetti di Fusione dei Dati

Normalizzazione

Ogni exchange ha nomi di campo, precisione decimale e strutture dati diverse. Smart Money normalizza tutto su uno schema standard:

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

Allineamento dei Timestamp

Tutti i punti dati sono timestampati e allineati ai millisecondi UTC. I dati più vecchi sono gestiti in modo trasparente:

Dati in tempo reale: ottenuti negli ultimi 5 secondi
Dati invecchiati: contrassegnati con age_ms che indica l'obsolescenza
Exchange mancanti: restituisce risultati parziali con l'elenco degli exchange
Dati completamente obsoleti: restituisce un risultato memorizzato con cache_age_seconds

Metadati Cross-Exchange

Ogni risposta aggregata include metadati sulle fonti dei dati:

Metadati di Aggregazione
{
 "data": [...],
 "_meta": {
 "exchanges": ["bybit", "binance", "hyperliquid"],
 "count": 245,
 "aggregated_at": 1709980800123,
 "sources_healthy": true
  }
}

Filtraggio di Base

Filtra per Exchange

Richiedi dati solo da exchange specifici:

Filtro Singolo Exchange
// Ottieni i tassi di funding solo da Binance
GET /v1/derivatives/funding-heatmap?exchange=binance
// Più exchange
GET /v1/derivatives/funding-heatmap?exchange=bybit,binance

Filtra per Classe di Asset

Filtra per criptovaluta o coppia di trading:

Filtro Asset
// Solo coppie Bitcoin
GET /v1/derivatives/funding-heatmap?asset=BTC
// Più asset
GET /v1/derivatives/funding-heatmap?asset=BTC,ETH,SOL
// Coppie specifiche
GET /v1/derivatives/funding-heatmap?symbol=BTCUSDT,ETHUSDT

Filtra per Intervallo Metrico

Interroga in base a valori numerici:

Filtri di Intervallo
// Tassi di funding alti (>0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_min=0.0001
// Tassi di funding bassi (<-0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_max=-0.0001
// Open interest alto
GET /v1/derivatives/oi-rankings?oi_min=100000000

Filtraggio Avanzato

Filtri Comparativi

Trova coppie con caratteristiche specifiche tra exchange:

Query Comparativi
// Coppie con differenza di funding >5% tra exchange
GET /v1/derivatives/comparative?metric=funding_rate_spread&min=0.0005
// Divergenza di liquidazione
GET /v1/derivatives/comparative?metric=liquidation_pressure_diff
// Coppie con il rapporto di open interest Bybit/Binance più alto
GET /v1/derivatives/comparative?metric=oi_ratio&base=bybit&compare=binance&min=1.5

Filtri Basati sul Tempo

Interroga dati aggregati storici:

Filtri Temporali
// Dati da una finestra temporale specifica
GET /v1/derivatives/funding-heatmap?start_time=1709980800&end_time=1709984400
// Ultime 24 ore
GET /v1/derivatives/funding-heatmap?lookback=24h
// Snapshot a intervalli di 1 ora
GET /v1/derivatives/historical?interval=1h&limit=24

Filtri Compositi

Combina più condizioni di filtraggio:

Query Complessa
// Coppie di top tier: BTC, ETH, SOL
// Funding positivo alto su Binance
// Funding negativo su Bybit (arbitraggio)
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

Ordinamento e Classifica

Direzioni di Ordinamento

Controlla l'ordinamento dei risultati:

Esempi di Ordinamento
// Tassi di funding più alti per primi
GET /v1/derivatives/funding-heatmap?sort=funding_rate:desc
// Open interest più basso
GET /v1/derivatives/oi-rankings?sort=open_interest:asc
// Timestamp più recente
GET /v1/derivatives/funding-heatmap?sort=timestamp:desc
// Ordinamento multi-campo
GET /v1/derivatives?sort=exchange:asc,funding_rate:desc

Opzioni di Classifica

Campo	Descrizione	Intervallo
funding_rate	Tasso di funding del contratto perpetuo	-1.0 a 1.0
open_interest	Posizioni aperte totali in USD	0 a miliardi
mark_price	Prezzo di mark/settlement del contratto	Positivo
liquidation_pressure	Rischio di liquidazione long vs short	-1.0 a 1.0

Modalità di Aggregazione dei Dati

Aggregazione Grezza

Restituisce tutti i punti dati separatamente con identificazione della fonte dell'exchange:

Modalità Grezza
GET /v1/derivatives/funding-heatmap?aggregate_mode=raw&symbol=BTCUSDT
// Risposta: 3 voci separate (una per exchange)
[
  { exchange: "bybit", funding_rate: 0.00010 },
  { exchange: "binance", funding_rate: 0.00012 },
  { exchange: "hyperliquid", funding_rate: 0.00009 }
]

Aggregazione Unificata

Combina i dati in un singolo record con campi statistici:

Modalità Unificata
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 }
}

Aggregazione Composita

Aggregazione statistica con punteggi di confidenza:

Modalità Composita
GET /v1/derivatives/funding-heatmap?aggregate_mode=composite&symbol=BTCUSDT
{
  symbol: "BTCUSDT",
  funding_rate_consensus: 0.000103,
  confidence_score: 0.98,  // 98% accordo
  outliers: [],
  weighted_avg: 0.000102,  // media ponderata per liquidità
  exchange_details: { ... }
}

Normalizzazione dei Dati

Normalizzazione dei Prezzi

Tutti i prezzi sono normalizzati a 8 decimali e denominazione USDT:

Bybit: coppie USDT normalizzate direttamente
Binance: USDT-M e COIN-M entrambi convertiti in forma standard
Hyperliquid: conversione nativa di USDT coerente

Normalizzazione del volume

Tutti i volumi sono riportati in unità dell'asset base:

Campi del volume
{
 "volume_base": 1234.5,  // BTC
 "volume_quote": 89234500,  // USDT
 "num_trades": 45678
}

Normalizzazione del timestamp

Tutti i timestamp sono in millisecondi UTC (13 cifre)
Sincronizzati con l'orologio dell'API gateway
Adeguamento dell'età per i dati raccolti in momenti diversi
Indipendente dal fuso orario (sempre UTC)

Esempi pratici di query

Esempio 1: Opportunità di arbitraggio sui tassi di funding

Trova coppie con il massimo spread tra il funding lungo su Binance e quello corto su Bybit:

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

Esempio 2: Contratti con alto open interest

Ottieni i contratti con open interest significativo su tutti gli exchange:

Query di liquidità
GET /v1/derivatives/oi-rankings?
  oi_min=100000000&
  sort=open_interest:desc&
  limit=20&
  aggregate_mode=merged

Esempio 3: Aggregazione temporale

Tassi di funding storici a intervalli di 4 ore:

Aggregazione storica
GET /v1/historical/funding?
  symbol=BTCUSDT&
  interval=4h&
  limit=30&
  aggregate_mode=composite

Consigli sulle prestazioni

1. Usa filtri specifici

Più specifica è la tua query, più veloce sarà la risposta. Filtrare 800 coppie fino a 5 restituisce risultati più velocemente che richiedere tutto.

2. Limita il set di risultati

Specifica sempre un parametro limit. Il valore predefinito è 100; il massimo è 1000. Set di risultati grandi sono più lenti e consumano più banda.

3. Scegli la modalità di aggregazione

Le modalità merged e composite sono più veloci della modalità raw per dataset piccoli. La modalità raw è migliore per analisi dettagliate su singoli exchange.

4. Usa la cache in modo aggressivo

Queste risposte hanno tempi di cache prevedibili. Implementa una cache locale per evitare richieste ridondanti.

5. Usa intervalli di tempo specifici

Le query storiche con finestre temporali ristrette sono molto più veloci dei parametri di lookback aperti.

Padroneggia i dati multi-exchange

Ottieni dati unificati sui derivati da Bybit, Binance e Hyperliquid con potenti filtri, aggregazione e normalizzazione. Risparmia tempo di sviluppo e riduci i costi delle API.

Visualizza i piani

Il piano gratuito include l'aggregazione di base. I piani Trader e Pro sbloccano filtri avanzati e query storiche.