Data Models & Schema Reference

Rujukan lengkap untuk model data Smart Money API. Pelajari struktur dan definisi medan untuk semua objek respons termasuk posisi paus, kadar pembiayaan, pelepasan, dan skor pengesahan AI.

Gambaran Keseluruhan

Memahami struktur respons API adalah penting untuk membina integrasi. Rujukan ini mendokumentasikan semua definisi model data, jenis medan, kekangan, dan contoh. Semua cap masa dalam format ISO 8601 UTC. Semua harga dan jumlah dikembalikan sebagai rentetan untuk mengelakkan kehilangan ketepatan titik terapung.

Objek Posisi Paus

Mewakili posisi besar yang dipegang oleh dompet paus yang dipantau di bursa perdagangan leverage.

Medan	Jenis	Penerangan
id	rentetan	Pengenal pasti posisi unik
wallet_address	rentetan	Alamat dompet paus (format 0x...)
exchange	rentetan	bybit, binance, atau hyperliquid
symbol	rentetan	Pasangan dagangan (BTCUSDT, ETHUSDT, dll.)
position_type	rentetan	panjang atau pendek
position_size	rentetan	Saiz dalam aset asas (cth., BTC)
entry_price	rentetan	Harga kemasukan purata dalam USDT
current_price	rentetan	Harga mark semasa dalam USDT
liquidation_price	rentetan	Harga di mana posisi akan dilepaskan
pnl	rentetan	P&L belum direalisasikan dalam USDT
pnl_percent	nombor	P&L belum direalisasikan sebagai peratusan
leverage	integer	Pengganda leverage (1-20x)
margin_balance	rentetan	Jumlah baki margin dalam USDT
used_margin	rentetan	Margin yang digunakan dalam USDT
available_margin	rentetan	Margin yang tersedia dalam USDT
margin_ratio	nombor	Nisbah margin tersedia / margin yang digunakan
funding_rate	rentetan	Kadar pembiayaan semasa (% setiap jam)
time_opened	rentetan	Cap masa ISO 8601 apabila dibuka
last_updated	rentetan	Cap masa ISO 8601 kemas kini terakhir

Contoh Posisi Paus

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

Objek Kadar Pembiayaan

Mewakili kadar pembiayaan merentasi pelbagai bursa untuk satu simbol dan tempoh masa.

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

Objek Pelepasan

Mewakili pelepasan paksa posisi leverage.

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

Objek Minat Terbuka

Mewakili minat terbuka agregat merentasi semua peniaga leverage.

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

Objek Skor Pengesahan

Isyarat dagangan yang dijana AI yang menggabungkan posisi paus, data on-chain, kadar pembiayaan, dan sentimen pasaran.

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": "Pengumpulan paus besar dengan isyarat on-chain positif",
  "next_update": "2026-03-21T14:45:00Z"
}

Objek Metrik On-Chain

Analitik on-chain untuk Bitcoin dan 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"
}

Objek Respons Ralat

Format respons ralat standard untuk semua endpoint.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Pengesahan permintaan gagal",
    "details": [
      {
        "field": "symbol",
        "error": "Format pasangan dagangan tidak sah"
      }
    ],
    "resolution": "Gunakan format seperti BTCUSDT"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Terokai Semua Model Data

Semak definisi skema lengkap dan kekangan medan untuk integrasi anda.

Lihat Rujukan API REST