डेटा मॉडल और स्कीमा संदर्भ

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	USDT में अनरियलाइज़्ड P&L
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"
}

ऑन-चेन मेट्रिक्स ऑब्जेक्ट

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

त्रुटि प्रतिक्रिया ऑब्जेक्ट

सभी एंडपॉइंट्स के लिए स्टैंडर्ड त्रुटि प्रतिक्रिया फॉर्मेट।

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 संदर्भ देखें