Моделі даних та довідник схем

Повний довідник моделей даних 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, що поєднує позиції китів, дані on-chain, ставки фінансування та ринкові настрої.

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": "Велике накопичення китів із позитивними сигналами on-chain",
  "next_update": "2026-03-21T14:45:00Z"
}

Об’єкт метрик On-Chain

Аналітика on-chain для 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": "Помилка валідації запиту",
    "details": [
      {
        "field": "symbol",
        "error": "Невірний формат торгової пари"
      }
    ],
    "resolution": "Використовуйте формат на зразок BTCUSDT"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Дослідіть усі моделі даних

Перегляньте повні визначення схем та обмеження полів для вашої інтеграції.

Переглянути довідник REST API