Mô Hình Dữ Liệu & Tham Chiếu Schema

Tài liệu tham khảo đầy đủ cho các mô hình dữ liệu Smart Money API. Tìm hiểu cấu trúc và định nghĩa trường cho tất cả đối tượng phản hồi bao gồm vị thế cá voi, tỷ lệ funding, thanh lý và điểm xác nhận AI.

Tổng quan

Hiểu cấu trúc phản hồi API là điều cần thiết để xây dựng tích hợp. Tài liệu này ghi lại tất cả định nghĩa mô hình dữ liệu, loại trường, ràng buộc và ví dụ. Tất cả dấu thời gian đều ở định dạng ISO 8601 UTC. Tất cả giá và số lượng được trả về dưới dạng chuỗi để tránh mất độ chính xác số thập phân.

Đối Tượng Vị Thế Cá Voi

Đại diện cho một vị thế lớn được nắm giữ bởi ví cá voi được theo dõi trên sàn giao dịch đòn bẩy.

Trường	Loại	Mô tả
id	string	Định danh vị thế duy nhất
wallet_address	string	Địa chỉ ví cá voi (định dạng 0x...)
exchange	string	bybit, binance, hoặc hyperliquid
symbol	string	Cặp giao dịch (BTCUSDT, ETHUSDT, v.v.)
position_type	string	long hoặc short
position_size	string	Kích thước bằng tài sản cơ sở (ví dụ: BTC)
entry_price	string	Giá vào lệnh trung bình bằng USDT
current_price	string	Giá đánh dấu hiện tại bằng USDT
liquidation_price	string	Giá mà vị thế bị thanh lý
pnl	string	Lãi/Lỗ chưa thực hiện bằng USDT
pnl_percent	number	Lãi/Lỗ chưa thực hiện theo phần trăm
leverage	integer	Đòn bẩy nhân (1-20x)
margin_balance	string	Tổng số dư ký quỹ bằng USDT
used_margin	string	Ký quỹ đã sử dụng bằng USDT
available_margin	string	Ký quỹ khả dụng bằng USDT
margin_ratio	number	Tỷ lệ ký quỹ khả dụng / ký quỹ đã sử dụng
funding_rate	string	Tỷ lệ funding hiện tại (% hàng giờ)
time_opened	string	Dấu thời gian ISO 8601 khi mở
last_updated	string	Dấu thời gian ISO 8601 của lần cập nhật cuối

Ví Dụ Vị Thế Cá Voi

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

Đối Tượng Tỷ Lệ Funding

Đại diện cho tỷ lệ funding trên nhiều sàn giao dịch cho một cặp giao dịch và khoảng thời gian.

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

Đối Tượng Thanh Lý

Đại diện cho việc thanh lý cưỡng chế một vị thế đòn bẩy.

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

Đối Tượng Open Interest

Đại diện cho tổng open interest của tất cả trader đòn bẩy.

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

Đối Tượng Điểm Xác Nhận

Tín hiệu giao dịch được tạo bởi AI kết hợp vị thế cá voi, dữ liệu on-chain, tỷ lệ funding và tâm lý thị trường.

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": "Tích lũy cá voi lớn với tín hiệu on-chain tích cực",
  "next_update": "2026-03-21T14:45:00Z"
}

Đối Tượng Chỉ Số On-Chain

Phân tích on-chain cho Bitcoin và 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"
}

Đối Tượng Phản Hồi Lỗi

Định dạng phản hồi lỗi tiêu chuẩn cho tất cả endpoint.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Xác thực yêu cầu thất bại",
    "details": [
      {
        "field": "symbol",
        "error": "Định dạng cặp giao dịch không hợp lệ"
      }
    ],
    "resolution": "Sử dụng định dạng như BTCUSDT"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Khám Phá Tất Cả Mô Hình Dữ Liệu

Xem lại định nghĩa schema đầy đủ và ràng buộc trường cho tích hợp của bạn.

Xem Tham Chiếu REST API