ڈیٹا ماڈلز اور اسکیما ریفرنس

Smart Money API کے ڈیٹا ماڈلز کی مکمل ریفرنس۔ تمام رسپانس آبجیکٹس کی ساخت اور فیلڈ تعریفات سیکھیں جن میں وہیل پوزیشنز، فنڈنگ ریٹس، لکویڈیشنز، اور AI کنفرمیشن اسکورز شامل ہیں۔

جائزہ

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	غیر حقیقی P&L USDT میں
pnl_percent	number	غیر حقیقی P&L فیصد کے طور پر
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"
    }
  }
}

کنفرمیشن اسکور آبجیکٹ

وہیل پوزیشنز، آن چین ڈیٹا، فنڈنگ ریٹس، اور مارکیٹ سینٹی منٹ کو ملا کر 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"
}

آن چین میٹرکس آبجیکٹ

بٹ کوائن اور ایتھیریم کے لیے آن چین اینالیٹکس۔

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": "Request validation failed",
    "details": [
      {
        "field": "symbol",
        "error": "Invalid trading pair format"
      }
    ],
    "resolution": "Use format like BTCUSDT"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

تمام ڈیٹا ماڈلز کو دریافت کریں

اپنی انٹیگریشن کے لیے مکمل اسکیما تعریفات اور فیلڈ رکاوٹوں کا جائزہ لیں۔

REST API ریفرنس دیکھیں