โมเดลข้อมูล & โครงสร้างข้อมูลอ้างอิง

ข้อมูลอ้างอิงแบบครบถ้วนสำหรับโมเดลข้อมูลของ Smart Money API เรียนรู้โครงสร้างและคำจำกัดความของฟิลด์สำหรับออบเจ็กต์การตอบกลับทั้งหมด รวมถึงตำแหน่งวอลเล็ตใหญ่ อัตราเงินทุน การชำระบัญชี และคะแนนยืนยันจาก AI

ภาพรวม

การเข้าใจโครงสร้างการตอบกลับของ API เป็นสิ่งสำคัญสำหรับการสร้างการเชื่อมต่อ ข้อมูลอ้างอิงนี้บันทึกคำจำกัดความของโมเดลข้อมูล ชนิดฟิลด์ ข้อจำกัด และตัวอย่างทั้งหมด เวลาทั้งหมดอยู่ในรูปแบบ ISO 8601 UTC ราคาและจำนวนทั้งหมดจะถูกส่งกลับเป็นสตริงเพื่อป้องกันการสูญเสียความแม่นยำของทศนิยม

ออบเจ็กต์ตำแหน่งวอลเล็ตใหญ่ (Whale Position Object)

แสดงถึงตำแหน่งขนาดใหญ่ที่ถือโดยวอลเล็ตวอลเล็ตใหญ่ที่ถูกติดตามบนแพลตฟอร์มเทรดแบบมีเลเวอเรจ

ฟิลด์	ชนิด	คำอธิบาย
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"
}

ออบเจ็กต์อัตราเงินทุน (Funding Rate Object)

แสดงอัตราเงินทุนจากหลายแพลตฟอร์มสำหรับสัญลักษณ์และช่วงเวลาเดียว

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

ออบเจ็กต์การชำระบัญชี (Liquidation Object)

แสดงถึงการชำระบัญชีตำแหน่งแบบมีเลเวอเรจ

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

ออบเจ็กต์ยอดเปิดเผย (Open Interest Object)

แสดงยอดเปิดเผยรวมจากผู้เทรดแบบมีเลเวอเรจทั้งหมด

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

ออบเจ็กต์คะแนนยืนยัน (Confirmation Score Object)

สัญญาณการเทรดที่สร้างโดย AI รวมตำแหน่งวอลเล็ตใหญ่ ข้อมูลบนบล็อกเชน อัตราเงินทุน และความรู้สึกตลาด

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": "Large whale accumulation with positive on-chain signals",
  "next_update": "2026-03-21T14:45:00Z"
}

ออบเจ็กต์ตัวชี้วัดบนบล็อกเชน (On-Chain Metrics Object)

การวิเคราะห์บนบล็อกเชนสำหรับ 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"
}

ออบเจ็กต์การตอบกลับเมื่อเกิดข้อผิดพลาด (Error Response Object)

รูปแบบการตอบกลับเมื่อเกิดข้อผิดพลาดมาตรฐานสำหรับทุกเอ็นด์พอยต์

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Request validation failed",
    "details": [
      {
        "field": "symbol",
        "error": "Invalid trading pair format"
      }
    ],
    "resolution": "Use format like BTCUSDT"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

สำรวจโมเดลข้อมูลทั้งหมด

ตรวจสอบคำจำกัดความโครงสร้างและข้อจำกัดของฟิลด์สำหรับการเชื่อมต่อของคุณ

ดูข้อมูลอ้างอิง REST API