Modèles de données & Référence de schéma

Référence complète des modèles de données de l'API Smart Money. Apprenez la structure et les définitions des champs pour tous les objets de réponse, y compris les positions des baleines, les taux de financement, les liquidations et les scores de confirmation IA.

Aperçu

Comprendre les structures de réponse API est essentiel pour créer des intégrations. Cette référence documente toutes les définitions de modèles de données, types de champs, contraintes et exemples. Tous les horodatages sont au format ISO 8601 UTC. Tous les prix et montants sont renvoyés sous forme de chaînes pour éviter les pertes de précision en virgule flottante.

Objet Position de baleine

Représente une position importante détenue par un portefeuille de baleine surveillé sur une plateforme de trading avec effet de levier.

Champ	Type	Description
id	string	Identifiant unique de la position
wallet_address	string	Adresse du portefeuille de la baleine (format 0x...)
exchange	string	bybit, binance ou hyperliquid
symbol	string	Paire de trading (BTCUSDT, ETHUSDT, etc.)
position_type	string	long ou short
position_size	string	Taille en actif de base (ex. BTC)
entry_price	string	Prix d'entrée moyen en USDT
current_price	string	Prix actuel du marché en USDT
liquidation_price	string	Prix de liquidation de la position
pnl	string	P&L non réalisé en USDT
pnl_percent	number	P&L non réalisé en pourcentage
leverage	integer	Multiplicateur de levier (1-20x)
margin_balance	string	Marge totale en USDT
used_margin	string	Marge utilisée en USDT
available_margin	string	Marge disponible en USDT
margin_ratio	number	Ratio marge disponible / marge utilisée
funding_rate	string	Taux de financement actuel (% horaire)
time_opened	string	Horodatage ISO 8601 d'ouverture
last_updated	string	Horodatage ISO 8601 de dernière mise à jour

Exemple de position de baleine

JSON

{
  "id": "pos_1a2b3c4d5e6f7g8h",
  "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
  "exchange": "bybit",
  "symbol": "BTCUSDT",
  "position_type": "long",
  "position_size": "15.5",
  "entry_price": "42150.00",
  "current_price": "43200.50",
  "liquidation_price": "34560.00",
  "pnl": "16577.75",
  "pnl_percent": 3.91,
  "leverage": 5,
  "margin_balance": "129000.00",
  "used_margin": "126225.00",
  "available_margin": "2775.00",
  "margin_ratio": 0.022,
  "funding_rate": "0.00012",
  "time_opened": "2026-03-15T08:30:00Z",
  "last_updated": "2026-03-21T14:35:45Z"
}

Objet Taux de financement

Représente les taux de financement sur plusieurs plateformes pour un seul symbole et une période donnée.

JSON

{
  "timestamp": "2026-03-21T14:00:00Z",
  "symbol": "BTCUSDT",
  "bybit": {
    "rate": "0.000120",
    "next_funding_time": "2026-03-21T16:00:00Z",
    "next_rate": "0.000145"
  },
  "binance": {
    "rate": "0.000098",
    "next_funding_time": "2026-03-21T16:00:00Z",
    "next_rate": "0.000115"
  },
  "hyperliquid": {
    "rate": "0.000140",
    "next_funding_time": "2026-03-21T16:00:00Z",
    "next_rate": "0.000160"
  },
  "aggregated": {
    "mean": "0.000119",
    "median": "0.000120",
    "highest": "0.000160",
    "lowest": "0.000098",
    "spread": "0.000062"
  }
}

Objet Liquidation

Représente une liquidation forcée d'une position avec effet de levier.

JSON

{
  "id": "liq_1a2b3c4d5e6f7g8h",
  "exchange": "binance",
  "symbol": "BTCUSDT",
  "direction": "long",
  "position_size": "12.5",
  "liquidation_price": "41000.00",
  "size_usd": "512500.00",
  "timestamp": "2026-03-21T14:35:12Z"
}

Objet Intérêt ouvert

Représente l'intérêt ouvert agrégé de tous les traders avec effet de levier.

JSON

{
  "symbol": "BTCUSDT",
  "timestamp": "2026-03-21T14:00:00Z",
  "total_oi_usd": "12456000000.00",
  "long_oi_usd": "7234000000.00",
  "short_oi_usd": "5222000000.00",
  "long_short_ratio": 1.385,
  "oi_change_percent": 2.34,
  "exchanges": {
    "bybit": {
      "long": "3456000000.00",
      "short": "2123000000.00"
    },
    "binance": {
      "long": "2567000000.00",
      "short": "2234000000.00"
    },
    "hyperliquid": {
      "long": "1211000000.00",
      "short": "865000000.00"
    }
  }
}

Objet Score de confirmation

Signal de trading généré par IA combinant positions de baleines, données on-chain, taux de financement et sentiment de marché.

JSON

{
  "symbol": "BTCUSDT",
  "overall_score": 78,
  "signal": "bullish",
  "confidence": 0.85,
  "timestamp": "2026-03-21T14:30:00Z",
  "components": {
    "whale_score": 82,
    "on_chain_score": 75,
    "funding_score": 68,
    "liquidation_score": 72,
    "sentiment_score": 85
  },
  "reasoning": "Accumulation importante par les baleines avec signaux on-chain positifs",
  "next_update": "2026-03-21T14:45:00Z"
}

Objet Métriques On-Chain

Analytiques on-chain pour Bitcoin et Ethereum.

JSON

{
  "asset": "bitcoin",
  "timestamp": "2026-03-21T00:00:00Z",
  "exchange_flow": {
    "inflow_btc": "245.67",
    "outflow_btc": "812.34",
    "net_flow_btc": "-566.67"
  },
  "whale_wallets": {
    "count": 412,
    "total_btc": "1243567.89",
    "change_24h": 15.23
  },
  "mvrv_ratio": 1.42,
  "nupl": 0.68,
  "realized_price": "42156.50"
}

Objet Réponse d'erreur

Format standard de réponse d'erreur pour tous les endpoints.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Échec de la validation de la requête",
    "details": [
      {
        "field": "symbol",
        "error": "Format de paire de trading invalide"
      }
    ],
    "resolution": "Utilisez un format comme BTCUSDT"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Explorer tous les modèles de données

Consultez les définitions complètes de schéma et les contraintes de champs pour votre intégration.

Voir la référence de l'API REST