ডাটা মডেল এবং স্কিমা রেফারেন্স

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

অন-চেইন মেট্রিক্স অবজেক্ট

বিটকয়েন এবং ইথেরিয়ামের জন্য অন-চেইন অ্যানালিটিক্স।

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 রেফারেন্স দেখুন