مرجع مدل‌های داده و اسکیما

مرجع کامل برای مدل‌های داده Smart Money API. ساختار و تعاریف فیلدها برای تمام اشیاء پاسخ شامل موقعیت‌های نهنگ، نرخ‌های تامین مالی، تصفیه‌ها و امتیازهای تایید هوش مصنوعی را یاد بگیرید.

مرور کلی

درک ساختارهای پاسخ API برای ساخت یکپارچه‌سازی‌ها ضروری است. این مرجع تمام تعاریف مدل‌های داده، انواع فیلدها، محدودیت‌ها و مثال‌ها را مستند می‌کند. تمام زمان‌ها در قالب UTC ISO 8601 هستند. تمام قیمت‌ها و مقادیر به عنوان رشته بازگردانده می‌شوند تا از از دست دادن دقت نقطه شناور جلوگیری شود.

شیء موقعیت نهنگ

نمایانگر یک موقعیت بزرگ نگهداری شده توسط یک کیف پول نهنگ تحت نظارت در یک صرافی معاملات اهرمی.

فیلد	نوع	توضیح
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