Data Models & Schema Reference

Smart Money API දත්ත ආකෘති සඳහා සම්පූර්ණ යොමුව. වේල් ස්ථාන, අරමුදල් අනුපාත, ද්රවීකරණ සහ AI තහවුරු කිරීමේ ලකුණු ඇතුළු සියලුම ප්රතිචාර වස්තූන්ගේ ව්යුහය සහ ක්ෂේත්ර අර්ථ දැක්වීම් ඉගෙන ගන්න.

Overview

API ප්රතිචාර ව්යුහයන් තේරුම් ගැනීම ඒකාබද්ධතා ගොඩනැගීම සඳහා අත්යවශ්ය වේ. මෙම යොමුව සියලුම දත්ත ආකෘති අර්ථ දැක්වීම්, ක්ෂේත්ර වර්ග, සීමාවන් සහ උදාහරණ ලියාපදිංචි කරයි. සියලුම කාල සටහන් ISO 8601 UTC ආකෘතියෙන් ඇත. සියලුම මිල සහ ප්රමාණ පාවෙන ලක්ෂ්ය නිරවද්යතා අලාභය වළක්වා ගැනීම සඳහා නූල් ලෙස ආපසු ලබා දෙනු ලැබේ.

Whale Position Object

ලෙවරේජ් වෙළඳපොලක නිරීක්ෂණය කරන වේල් රසිකයක් තබා ඇති විශාල ස්ථානයක් නියෝජනය කරයි.

Field	Type	Description
id	string	අද්විතීය ස්ථාන හඳුනාගැනීම
wallet_address	string	වේල් රසිකයේ ලිපිනය (0x... ආකෘතිය)
exchange	string	bybit, binance, හෝ hyperliquid
symbol	string	වෙළඳ යුගලය (BTCUSDT, ETHUSDT, ආදිය)
position_type	string	දිගු හෝ කෙටි
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 කාල සටහන අවසන් යාවත්කාලීනය

Example Whale Position

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

Funding Rate Object

එක් සංකේතයක් සහ කාල පරිච්ඡේදයක් සඳහා බහු වෙළඳපොල්වල අරමුදල් අනුපාත නියෝජනය කරයි.

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

Liquidation Object

ලෙවරේජ් ස්ථානයක බලහත්කාර ද්රවීකරණයක් නියෝජනය කරයි.

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

Open Interest Object

සියලුම ලෙවරේජ් වෙළඳුන්ගේ සමස්ත විවෘත උනන්දුව නියෝජනය කරයි.

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

Confirmation Score Object

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

On-Chain Metrics Object

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

Error Response Object

සියලුම අවසාන ලක්ෂ්ය සඳහා සම්මත දෝෂ ප්රතිචාර ආකෘතිය.

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

Explore All Data Models

ඔබගේ ඒකාබද්ධතාව සඳහා සම්පූර්ණ යෝජනා අර්ථ දැක්වීම් සහ ක්ෂේත්ර සීමාවන් සමාලෝචනය කරන්න.

View REST API Reference