Modele de Date & Referință de Schema

Referință completă pentru modelele de date Smart Money API. Învață structura și definițiile câmpurilor pentru toate obiectele de răspuns, inclusiv poziții whale, rate de finanțare, lichidări și scoruri de confirmare AI.

Prezentare generală

Înțelegerea structurilor de răspuns API este esențială pentru construirea integraților. Această referință documentează toate definițiile modelelor de date, tipurile de câmpuri, constrângerile și exemplele. Toate marcajele de timp sunt în format ISO 8601 UTC. Toate prețurile și sumele sunt returnate ca șiruri pentru a preveni pierderea de precizie în virgulă mobilă.

Obiect Poziție Whale

Reprezintă o poziție mare deținută de un portofel whale monitorizat pe o bursă de tranzacționare cu levier.

Câmp	Tip	Descriere
id	string	Identificator unic al poziției
wallet_address	string	Adresa portofelului whale (format 0x...)
exchange	string	bybit, binance sau hyperliquid
symbol	string	Pereche de tranzacționare (BTCUSDT, ETHUSDT etc.)
position_type	string	long sau short
position_size	string	Mărime în activul de bază (ex., BTC)
entry_price	string	Preț mediu de intrare în USDT
current_price	string	Preț curent de marcaj în USDT
liquidation_price	string	Preț la care poziția este lichidată
pnl	string	P&L nerealizat în USDT
pnl_percent	number	P&L nerealizat ca procentaj
leverage	integer	Multiplicator de levier (1-20x)
margin_balance	string	Sold total de marjă în USDT
used_margin	string	Marjă utilizată în USDT
available_margin	string	Marjă disponibilă în USDT
margin_ratio	number	Raport marjă disponibilă / marjă utilizată
funding_rate	string	Rată de finanțare curentă (% orar)
time_opened	string	Marcaj de timp ISO 8601 când a fost deschisă
last_updated	string	Marcaj de timp ISO 8601 al ultimei actualizări

Exemplu Poziție Whale

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

Obiect Rată de Finanțare

Reprezintă ratele de finanțare pe mai multe burse pentru un singur simbol și perioadă de timp.

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

Obiect Lichidare

Reprezintă o lichidare forțată a unei poziții cu 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"
}

Obiect Interes Deschis

Reprezintă interesul deschis agregat al tuturor traderilor cu 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"
    }
  }
}

Obiect Scor de Confirmare

Semnal de tranzacționare generat de AI, combinând poziții whale, date on-chain, rate de finanțare și sentimentul pieței.

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": "Acumulare mare de whale cu semnale on-chain pozitive",
  "next_update": "2026-03-21T14:45:00Z"
}

Obiect Metrici On-Chain

Analize on-chain pentru Bitcoin și 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"
}

Obiect Răspuns de Eroare

Format standard de răspuns de eroare pentru toate endpoint-urile.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validarea cererii a eșuat",
    "details": [
      {
        "field": "symbol",
        "error": "Format invalid al perechii de tranzacționare"
      }
    ],
    "resolution": "Folosește formatul BTCUSDT"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Explorează Toate Modelele de Date

Revizuiește definițiile complete de schemă și constrângerile câmpurilor pentru integrarea ta.

Vezi Referința API REST