Data Models & Schema Reference

Kumpletong sanggunian para sa mga modelo ng datos ng Smart Money API. Alamin ang istruktura at mga kahulugan ng field para sa lahat ng mga object ng tugon kabilang ang mga posisyon ng whale, mga rate ng pagpopondo, mga paglilikido, at mga marka ng kumpirmasyon ng AI.

Pangkalahatang-ideya

Ang pag-unawa sa mga istruktura ng tugon ng API ay mahalaga para sa pagbuo ng mga integrasyon. Ang sangguniang ito ay nagdodokumento ng lahat ng mga kahulugan ng modelo ng datos, mga uri ng field, mga hadlang, at mga halimbawa. Ang lahat ng mga timestamp ay nasa format na ISO 8601 UTC. Ang lahat ng mga presyo at halaga ay ibinalik bilang mga string upang maiwasan ang pagkawala ng kawastuhan ng floating-point.

Whale Position Object

Kumakatawan sa isang malaking posisyon na hawak ng isang sinusubaybayang whale wallet sa isang leverage trading exchange.

Field	Type	Description
id	string	Natatanging identifier ng posisyon
wallet_address	string	Address ng whale wallet (format na 0x...)
exchange	string	bybit, binance, o hyperliquid
symbol	string	Pares ng pangangalakal (BTCUSDT, ETHUSDT, atbp.)
position_type	string	long o short
position_size	string	Laki sa base asset (hal., BTC)
entry_price	string	Average na presyo ng pagpasok sa USDT
current_price	string	Kasalukuyang mark price sa USDT
liquidation_price	string	Presyo kung saan malilikido ang posisyon
pnl	string	Hindi natutupad na P&L sa USDT
pnl_percent	number	Hindi natutupad na P&L bilang porsyento
leverage	integer	Multiplier ng leverage (1-20x)
margin_balance	string	Kabuuang balanse ng margin sa USDT
used_margin	string	Ginamit na margin sa USDT
available_margin	string	Available na margin sa USDT
margin_ratio	number	Ratio ng available na margin / ginamit na margin
funding_rate	string	Kasalukuyang rate ng pagpopondo (oras-oras na %)
time_opened	string	ISO 8601 timestamp nang buksan
last_updated	string	ISO 8601 timestamp ng huling update

Halimbawa ng 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

Kumakatawan sa mga rate ng pagpopondo sa maraming exchange para sa isang simbolo at panahon.

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

Kumakatawan sa sapilitang paglilikido ng isang leveraged position.

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

Kumakatawan sa kabuuang open interest sa lahat ng leverage traders.

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-generated na trading signal na pinagsasama ang mga posisyon ng whale, datos on-chain, mga rate ng pagpopondo, at sentimyento ng merkado.

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": "Malaking akumulasyon ng whale na may positibong signal on-chain",
  "next_update": "2026-03-21T14:45:00Z"
}

On-Chain Metrics Object

Mga analytics on-chain para sa Bitcoin at 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

Standard na format ng error response para sa lahat ng endpoint.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Nabigo ang pagpapatunay ng kahilingan",
    "details": [
      {
        "field": "symbol",
        "error": "Hindi wastong format ng pares ng pangangalakal"
      }
    ],
    "resolution": "Gumamit ng format tulad ng BTCUSDT"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Tuklasin ang Lahat ng Data Models

Suriin ang kumpletong mga kahulugan ng schema at mga hadlang ng field para sa iyong integrasyon.

Tingnan ang REST API Reference