Modelli di dati e riferimento allo schema

Riferimento completo per i modelli di dati di Smart Money API. Scopri la struttura e le definizioni dei campi per tutti gli oggetti di risposta, incluse le posizioni delle balene, i tassi di finanziamento, le liquidazioni e i punteggi di conferma AI.

Panoramica

Comprendere le strutture delle risposte API è essenziale per costruire integrazioni. Questo riferimento documenta tutte le definizioni dei modelli di dati, i tipi di campo, i vincoli e gli esempi. Tutti i timestamp sono nel formato UTC ISO 8601. Tutti i prezzi e gli importi vengono restituiti come stringhe per evitare la perdita di precisione dei numeri in virgola mobile.

Oggetto Posizione della balena

Rappresenta una grande posizione detenuta da un portafoglio balena monitorato su un exchange di trading con leva.

Campo	Tipo	Descrizione
id	string	Identificatore unico della posizione
wallet_address	string	Indirizzo del portafoglio balena (formato 0x...)
exchange	string	bybit, binance o hyperliquid
symbol	string	Coppia di trading (BTCUSDT, ETHUSDT, ecc.)
position_type	string	long o short
position_size	string	Dimensione nell'asset di base (es. BTC)
entry_price	string	Prezzo di ingresso medio in USDT
current_price	string	Prezzo di mark corrente in USDT
liquidation_price	string	Prezzo al quale la posizione viene liquidata
pnl	string	P&L non realizzato in USDT
pnl_percent	number	P&L non realizzato in percentuale
leverage	integer	Moltiplicatore di leva (1-20x)
margin_balance	string	Saldo totale del margine in USDT
used_margin	string	Margine utilizzato in USDT
available_margin	string	Margine disponibile in USDT
margin_ratio	number	Rapporto margine disponibile / margine utilizzato
funding_rate	string	Tasso di finanziamento corrente (% orario)
time_opened	string	Timestamp ISO 8601 di apertura
last_updated	string	Timestamp ISO 8601 dell'ultimo aggiornamento

Esempio di Posizione della balena

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"
}

Oggetto Tasso di finanziamento

Rappresenta i tassi di finanziamento su più exchange per un singolo simbolo e periodo di tempo.

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"
  }
}

Oggetto Liquidazione

Rappresenta una liquidazione forzata di una posizione con leva.

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"
}

Oggetto Interesse aperto

Rappresenta l'interesse aperto aggregato di tutti i trader con leva.

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"
    }
  }
}

Oggetto Punteggio di conferma

Segnale di trading generato dall'AI che combina posizioni delle balene, dati on-chain, tassi di finanziamento e sentiment di mercato.

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": "Grande accumulo di balene con segnali on-chain positivi",
  "next_update": "2026-03-21T14:45:00Z"
}

Oggetto Metriche on-chain

Analitiche on-chain per Bitcoin e 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"
}

Oggetto Risposta di errore

Formato standard di risposta di errore per tutti gli endpoint.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validazione della richiesta fallita",
    "details": [
      {
        "field": "symbol",
        "error": "Formato della coppia di trading non valido"
      }
    ],
    "resolution": "Usa un formato come BTCUSDT"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Esplora tutti i modelli di dati

Rivedi le definizioni complete dello schema e i vincoli dei campi per la tua integrazione.

Visualizza il riferimento API REST