Documentation de l'API
Agrégation de données multi-plateformes et filtrage avancé
Maîtrisez l'agrégation de données sur Bybit, Binance et Hyperliquid avec un filtrage avancé, un tri et une normalisation. Obtenez des insights de marché unifiés depuis 3+ plateformes simultanément.
Publié le 21 mars 2026
•
17 min de lecture
•
Avancé
Aperçu de l'agrégation de données
L'API Smart Money agrège les données de produits dérivés cryptos depuis 3 grandes plateformes : Bybit, Binance et Hyperliquid. Au lieu d'effectuer des appels API séparés à chaque plateforme, vous obtenez des données unifiées avec un filtrage intelligent, des comparaisons inter-plateformes et des capacités analytiques avancées.
Pourquoi l'agrégation compte :
- Un seul appel API — Obtenez des données de 3 plateformes simultanément sans gérer plusieurs connexions
- Format normalisé — Toutes les plateformes standardisées selon un schéma cohérent
- Insights inter-plateformes — Comparez les taux de financement, positions et liquidités entre plateformes
- Filtrage intelligent — Interrogez précisément les données dont vous avez besoin avec des filtres puissants
- Performance — Réponses agrégées en cache CDN 50x plus rapides qu'une agrégation manuelle
Architecture : L'API Smart Money collecte les données des plateformes toutes les 1-5 secondes, les normalise, les met en cache au niveau du CDN et sert des réponses agrégées avec une latence inférieure à 100ms à l'échelle mondiale.
Plateformes prises en charge
Bybit
Code : bybit | Couverture : 500+ paires perpétuelles | Fréquence de mise à jour : 1 seconde
- Futures perpétuels USDT (contrats linéaires)
- Perpétuels inversés (XRP, ETC)
- Données complètes de carnet d'ordres et trades
- Taux de financement et prix mark
Binance
Code : binance | Couverture : 800+ paires perpétuelles | Fréquence de mise à jour : 1 seconde
- Futures USDT-M (perpétuels USDT)
- Futures COIN-M (inversés)
- Données complètes de microstructure de marché
- Liquidité la plus élevée sur les paires
Hyperliquid
Code : hyperliquid | Couverture : 300+ paires perpétuelles | Fréquence de mise à jour : 5 secondes
- Futures perpétuels décentralisés (sans marge)
- Modèle de règlement on-chain unique
- Intégration native des données de portefeuilles de baleines
- Latence réduite pour les traders algorithmiques
Tableau des spécifications des plateformes
| Plateforme |
Paires |
Effet de levier |
Fréq. MAJ |
Règlement |
| bybit |
500+ |
1-125x |
1s |
Perpétuel |
| binance |
800+ |
1-125x |
1s |
Perpétuel |
| hyperliquid |
300+ |
1-20x |
5s |
Perpétuel |
Obtenez votre clé API en 30 secondes
Prêt à développer ? Obtenez une clé API gratuite (200 appels/jour, sans carte) et commencez à récupérer des données en direct sur les baleines, financements et on-chain.
Obtenez votre clé API →Concepts de fusion de données
Normalisation
Chaque plateforme a des noms de champs, précisions décimales et structures de données différents. Smart Money normalise tout selon un schéma standard :
{
"exchange": "bybit",
"symbol": "BTCUSDT",
"funding_rate": 0.0001,
"mark_price": 72500.50,
"index_price": 72480.25,
"open_interest": 850000000,
"timestamp": 1709980800000
}
Alignement des horodatages
Tous les points de données sont horodatés et alignés sur UTC en millisecondes. Les données anciennes sont gérées de manière transparente :
- Données temps réel : sourcées dans les 5 dernières secondes
- Données vieillissantes : marquées avec age_ms indiquant l'obsolescence
- Plateformes manquantes : retourne des résultats partiels avec liste des plateformes
- Données complètement obsolètes : retourne un résultat en cache avec cache_age_seconds
Métadonnées inter-plateformes
Chaque réponse agrégée inclut des métadonnées sur les sources de données :
{
"data": [...],
"_meta": {
"exchanges": ["bybit", "binance", "hyperliquid"],
"count": 245,
"aggregated_at": 1709980800123,
"sources_healthy": true
}
}
Filtrage de base
Filtrer par échange
Demander des données uniquement à partir d'échanges spécifiques :
// Obtenir les taux de financement uniquement depuis Binance
GET /v1/derivatives/funding-heatmap?exchange=binance
// Plusieurs échanges
GET /v1/derivatives/funding-heatmap?exchange=bybit,binance
Filtrer par classe d'actifs
Filtrer par crypto-monnaie ou paire de trading :
// Paires Bitcoin uniquement
GET /v1/derivatives/funding-heatmap?asset=BTC
// Plusieurs actifs
GET /v1/derivatives/funding-heatmap?asset=BTC,ETH,SOL
// Paires spécifiques
GET /v1/derivatives/funding-heatmap?symbol=BTCUSDT,ETHUSDT
Filtrer par plage métrique
Requête basée sur des valeurs numériques :
// Taux de financement élevés (>0,01 %)
GET /v1/derivatives/funding-heatmap?funding_rate_min=0.0001
// Taux de financement faibles (<-0,01 %)
GET /v1/derivatives/funding-heatmap?funding_rate_max=-0.0001
// Open interest élevé
GET /v1/derivatives/oi-rankings?oi_min=100000000
Filtrage avancé
Filtres comparatifs
Trouver des paires avec des caractéristiques spécifiques entre les échanges :
// Paires avec un écart de financement >5 % entre les échanges
GET /v1/derivatives/comparative?metric=funding_rate_spread&min=0.0005
// Divergence de liquidation
GET /v1/derivatives/comparative?metric=liquidation_pressure_diff
// Paires avec le ratio d'open interest Bybit/Binance le plus élevé
GET /v1/derivatives/comparative?metric=oi_ratio&base=bybit&compare=binance&min=1.5
Filtres temporels
Requête sur des données historiques agrégées :
// Données d'une plage horaire spécifique
GET /v1/derivatives/funding-heatmap?start_time=1709980800&end_time=1709984400
// 24 dernières heures
GET /v1/derivatives/funding-heatmap?lookback=24h
// Instantanés à intervalles d'1 heure
GET /v1/derivatives/historical?interval=1h&limit=24
Filtres composites
Combiner plusieurs conditions de filtrage :
// Pairs principales : BTC, ETH, SOL
// Financement positif élevé sur Binance
// Financement négatif sur Bybit (arbitrage)
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
Tri et classement
Directions de tri
Contrôler l'ordre des résultats :
// Taux de financement les plus élevés en premier
GET /v1/derivatives/funding-heatmap?sort=funding_rate:desc
// Open interest le plus faible
GET /v1/derivatives/oi-rankings?sort=open_interest:asc
// Horodatage le plus récent
GET /v1/derivatives/funding-heatmap?sort=timestamp:desc
// Tri multi-champs
GET /v1/derivatives?sort=exchange:asc,funding_rate:desc
Options de classement
| Champ |
Description |
Plage |
| funding_rate |
Taux de financement des contrats perpétuels |
-1.0 à 1.0 |
| open_interest |
Positions ouvertes totales en USD |
0 à milliards |
| mark_price |
Prix de marque/règlement du contrat |
Positif |
| liquidation_pressure |
Risque de liquidation longs vs shorts |
-1.0 à 1.0 |
Modes d'agrégation des données
Agrégation brute
Retourner tous les points de données séparément avec identification de l'échange source :
GET /v1/derivatives/funding-heatmap?aggregate_mode=raw&symbol=BTCUSDT
// Réponse : 3 entrées séparées (une par échange)
[
{ exchange: "bybit", funding_rate: 0.00010 },
{ exchange: "binance", funding_rate: 0.00012 },
{ exchange: "hyperliquid", funding_rate: 0.00009 }
]
Agrégation fusionnée
Combiner les données en un seul enregistrement avec des champs statistiques :
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 }
}
Agrégation composite
Agrégation statistique avec scores de confiance :
GET /v1/derivatives/funding-heatmap?aggregate_mode=composite&symbol=BTCUSDT
{
symbol: "BTCUSDT",
funding_rate_consensus: 0.000103,
confidence_score: 0.98, // Accord à 98 %
outliers: [],
weighted_avg: 0.000102, // Moyenne pondérée par la liquidité
exchange_details: { ... }
}
Normalisation des données
Normalisation des prix
Tous les prix sont normalisés à 8 décimales et en USDT :
- Bybit : paires USDT normalisées directement
- Binance : USDT-M et COIN-M convertis en forme standard
- Hyperliquid : Conversion native de l'USDT de manière cohérente
Normalisation du volume
Tous les volumes sont rapportés en unités de l'actif de base :
{
"volume_base": 1234.5,
"volume_quote": 89234500,
"num_trades": 45678
}
Normalisation des horodatages
- Tous les horodatages sont en millisecondes UTC (13 chiffres)
- Synchronisé avec l'horloge de la passerelle API
- Ajustement de l'âge pour les données collectées à différents moments
- Indépendant du fuseau horaire (toujours UTC)
Exemples pratiques de requêtes
Exemple 1 : Opportunités d'arbitrage sur les taux de financement
Trouvez les paires avec l'écart le plus élevé entre le financement long de Binance et le financement court de Bybit :
GET /v1/derivatives/funding-heatmap?
exchange=bybit,binance&
asset=BTC,ETH,SOL,ARB&
sort=funding_rate_spread:desc&
limit=10&
aggregate_mode=merged
Exemple 2 : Contrats à fort intérêt ouvert
Obtenez les contrats avec un intérêt ouvert significatif sur toutes les plateformes :
GET /v1/derivatives/oi-rankings?
oi_min=100000000&
sort=open_interest:desc&
limit=20&
aggregate_mode=merged
Exemple 3 : Agrégation de séries temporelles
Historique des taux de financement à intervalles de 4 heures :
GET /v1/historical/funding?
symbol=BTCUSDT&
interval=4h&
limit=30&
aggregate_mode=composite
Maîtrisez les données multi-plateformes
Obtenez des données dérivées unifiées de Bybit, Binance et Hyperliquid avec un filtrage puissant, une agrégation et une normalisation. Gagnez du temps en ingénierie et réduisez les coûts API.
Voir les plans
Le niveau gratuit inclut une agrégation de base. Les plans Trader et Pro débloquent un filtrage avancé et des requêtes historiques.