Referensi Data Models & Schema

Referensi lengkap untuk model data Smart Money API. Pelajari struktur dan definisi field untuk semua objek respons termasuk posisi paus, tingkat pendanaan, likuidasi, dan skor konfirmasi AI.

Ikhtisar

Memahami struktur respons API sangat penting untuk membangun integrasi. Referensi ini mendokumentasikan semua definisi model data, tipe field, batasan, dan contoh. Semua stempel waktu dalam format ISO 8601 UTC. Semua harga dan jumlah dikembalikan sebagai string untuk mencegah kehilangan presisi floating-point.

Objek Posisi Paus

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

Field	Tipe	Deskripsi
id	string	Pengenal posisi unik
wallet_address	string	Alamat dompet paus (format 0x...)
exchange	string	bybit, binance, atau hyperliquid
symbol	string	Pasangan perdagangan (BTCUSDT, ETHUSDT, dll.)
position_type	string	long atau short
position_size	string	Ukuran dalam aset dasar (misalnya, BTC)
entry_price	string	Harga masuk rata-rata dalam USDT
current_price	string	Harga mark saat ini dalam USDT
liquidation_price	string	Harga saat posisi dilikuidasi
pnl	string	P&L belum terealisasi dalam USDT
pnl_percent	number	P&L belum terealisasi dalam persentase
leverage	integer	Pengali leverage (1-20x)
margin_balance	string	Total saldo margin dalam USDT
used_margin	string	Margin yang digunakan dalam USDT
available_margin	string	Margin yang tersedia dalam USDT
margin_ratio	number	Rasio margin tersedia / margin yang digunakan
funding_rate	string	Tingkat pendanaan saat ini (per jam %)
time_opened	string	Stempel waktu ISO 8601 saat dibuka
last_updated	string	Stempel waktu ISO 8601 dari pembaruan 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 Tingkat Pendanaan

Mewakili tingkat pendanaan di beberapa bursa untuk satu simbol dan periode waktu.

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 Likuidasi

Mewakili likuidasi paksa dari 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 Bunga Terbuka

Mewakili bunga terbuka agregat di semua trader 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 Konfirmasi

Sinyal perdagangan yang dihasilkan AI yang menggabungkan posisi paus, data on-chain, tingkat pendanaan, dan sentimen pasar.

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": "Akumulasi paus besar dengan sinyal 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 Kesalahan

Format respons kesalahan standar untuk semua endpoint.

JSON

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

Jelajahi Semua Model Data

Tinjau definisi schema lengkap dan batasan field untuk integrasi Anda.

Lihat Referensi REST API