نماذج البيانات ومرجع المخططات

مرجع كامل لنماذج بيانات Smart Money API. تعرف على هيكل وتعريفات الحقول لجميع كائنات الاستجابة بما في ذلك مراكز الحيتان، معدلات التمويل، التصفيات، ودرجات تأكيد الذكاء الاصطناعي.

نظرة عامة

فهم هياكل استجابة 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"
    }
  }
}

كائن درجة التأكيد

إشارة تداول مولدة بالذكاء الاصطناعي تجمع بين مراكز الحيتان، بيانات السلسلة، معدلات التمويل، ومشاعر السوق.

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": "تراكم كبير للحيتان مع إشارات إيجابية من السلسلة",
  "next_update": "2026-03-21T14:45:00Z"
}

كائن مقاييس السلسلة

تحليلات السلسلة للبيتكوين والإيثيريوم.

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

كائن استجابة الخطأ

تنسيق استجابة الخطأ القياسي لجميع النقاط الطرفية.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "فشل التحقق من صحة الطلب",
    "details": [
      {
        "field": "symbol",
        "error": "تنسيق زوج تداول غير صالح"
      }
    ],
    "resolution": "استخدم تنسيقًا مثل BTCUSDT"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

استكشف جميع نماذج البيانات

راجع تعريفات المخططات الكاملة وقيود الحقول للتكامل الخاص بك.

عرض مرجع REST API