Μοντέλα Δεδομένων & Αναφορά Σχήματος

Πλήρης αναφορά για τα μοντέλα δεδομένων του Smart Money API. Μάθετε τη δομή και τους ορισμούς πεδίων για όλα τα αντικείμενα απόκρισης, συμπεριλαμβανομένων θέσεων φαλαινών, ποσοστών χρηματοδότησης, ρευστοποιήσεων και βαθμολογιών επιβεβαίωσης AI.

Επισκόπηση

Η κατανόηση των δομών απόκρισης API είναι απαραίτητη για τη δημιουργία ενσωματώσεων. Αυτή η αναφορά τεκμηριώνει όλους τους ορισμούς μοντέλων δεδομένων, τους τύπους πεδίων, τους περιορισμούς και παραδείγματα. Όλες οι χρονικές σημάνσεις είναι σε μορφή ISO 8601 UTC. Όλες οι τιμές και τα ποσά επιστρέφονται ως συμβολοσειρές για να αποφευχθεί η απώλεια ακρίβειας κινητής υποδιαστολής.

Αντικείμενο Θέσης Φάλαινας

Αντιπροσωπεύει μια μεγάλη θέση που κατέχει ένα πορτοφόλι φάλαινας σε μια πλατφόρμα συναλλαγών με μόχλευση.

Πεδίο	Τύπος	Περιγραφή
id	string	Μοναδικό αναγνωριστικό θέσης
wallet_address	string	Διεύθυνση πορτοφολιού φάλαινας (μορφή 0x...)
exchange	string	bybit, binance ή hyperliquid
symbol	string	Ζεύγος συναλλαγών (BTCUSDT, ETHUSDT, κλπ.)
position_type	string	long ή short
position_size	string	Μέγεθος σε βασικό περιουσιακό (π.χ., BTC)
entry_price	string	Μέση τιμή εισόδου σε USDT
current_price	string	Τρέχουσα τιμή σήμανσης σε USDT
liquidation_price	string	Τιμή στην οποία η θέση ρευστοποιείται
pnl	string	Μη πραγματοποιημένο κέρδος/ζημία σε USDT
pnl_percent	number	Μη πραγματοποιημένο κέρδος/ζημία ως ποσοστό
leverage	integer	Πολλαπλασιαστής μόχλευσης (1-20x)
margin_balance	string	Συνολικό περιθώριο σε USDT
used_margin	string	Χρησιμοποιημένο περιθώριο σε USDT
available_margin	string	Διαθέσιμο περιθώριο σε USDT
margin_ratio	number	Αναλογία διαθέσιμου περιθωρίου / χρησιμοποιημένου περιθωρίου
funding_rate	string	Τρέχον ποσοστό χρηματοδότησης (ωριαίο %)
time_opened	string	Χρονική σήμανση ISO 8601 όταν άνοιξε
last_updated	string	Χρονική σήμανση ISO 8601 τελευταίας ενημέρωσης

Παράδειγμα Θέσης Φάλαινας

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

Αντικείμενο Ποσοστού Χρηματοδότησης

Αντιπροσωπεύει ποσοστά χρηματοδότησης σε πολλαπλές πλατφόρμες για ένα συγκεκριμένο σύμβολο και χρονικό διάστημα.

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

Αντικείμενο Ρευστοποίησης

Αντιπροσωπεύει μια αναγκαστική ρευστοποίηση μιας θέσης με μόχλευση.

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

Αντικείμενο Ανοιχτού Ενδιαφέροντος

Αντιπροσωπεύει το συνολικό ανοιχτό ενδιαφέρον όλων των συμμετεχόντων με μόχλευση.

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

Αντικείμενο Βαθμολογίας Επιβεβαίωσης

Σήμα συναλλαγών που δημιουργήθηκε από AI, συνδυάζοντας θέσεις φαλαινών, δεδομένα on-chain, ποσοστά χρηματοδότησης και συναίσθημα αγοράς.

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": "Μεγάλη συσσώρευση από φάλαινες με θετικά σήματα on-chain",
  "next_update": "2026-03-21T14:45:00Z"
}

Αντικείμενο Μετρικών On-Chain

Αναλυτικά στοιχεία on-chain για Bitcoin και 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"
}

Αντικείμενο Απόκρισης Σφάλματος

Τυποποιημένη μορφή απόκρισης σφάλματος για όλα τα endpoints.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Αποτυχία επικύρωσης αιτήματος",
    "details": [
      {
        "field": "symbol",
        "error": "Μη έγκυρη μορφή ζεύγους συναλλαγών"
      }
    ],
    "resolution": "Χρησιμοποιήστε μορφή όπως BTCUSDT"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Εξερευνήστε Όλα τα Μοντέλα Δεδομένων

Ελέγξτε τους πλήρεις ορισμούς σχήματος και τους περιορισμούς πεδίων για την ενσωμάτωσή σας.

Δείτε την Αναφορά REST API