Modelos de Dados & Referência de Esquema

Referência completa dos modelos de dados da Smart Money API. Aprenda a estrutura e definições de campos para todos os objetos de resposta, incluindo posições de baleias, taxas de financiamento, liquidações e pontuações de confirmação de IA.

Visão Geral

Entender as estruturas de resposta da API é essencial para construir integrações. Esta referência documenta todas as definições de modelos de dados, tipos de campos, restrições e exemplos. Todos os timestamps estão no formato ISO 8601 UTC. Todos os preços e valores são retornados como strings para evitar perda de precisão em ponto flutuante.

Objeto Posição de Baleia

Representa uma grande posição mantida por uma carteira de baleia monitorada em uma exchange de trading alavancado.

Campo	Tipo	Descrição
id	string	Identificador único da posição
wallet_address	string	Endereço da carteira da baleia (formato 0x...)
exchange	string	bybit, binance ou hyperliquid
symbol	string	Par de trading (BTCUSDT, ETHUSDT, etc.)
position_type	string	long ou short
position_size	string	Tamanho no ativo base (ex.: BTC)
entry_price	string	Preço médio de entrada em USDT
current_price	string	Preço de marcação atual em USDT
liquidation_price	string	Preço em que a posição é liquidada
pnl	string	P&L não realizado em USDT
pnl_percent	number	P&L não realizado em porcentagem
leverage	integer	Multiplicador de alavancagem (1-20x)
margin_balance	string	Saldo total da margem em USDT
used_margin	string	Margem utilizada em USDT
available_margin	string	Margem disponível em USDT
margin_ratio	number	Razão margem disponível / margem utilizada
funding_rate	string	Taxa de financiamento atual (% por hora)
time_opened	string	Timestamp ISO 8601 quando aberto
last_updated	string	Timestamp ISO 8601 da última atualização

Exemplo de Posição de Baleia

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

Objeto Taxa de Financiamento

Representa as taxas de financiamento em várias exchanges para um único símbolo e período de tempo.

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

Objeto Liquidação

Representa uma liquidação forçada de uma posição alavancada.

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

Objeto Juros Abertos

Representa o juro aberto agregado de todos os traders alavancados.

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

Objeto Pontuação de Confirmação

Sinal de trading gerado por IA combinando posições de baleias, dados on-chain, taxas de financiamento e sentimento de mercado.

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": "Grande acumulação de baleias com sinais on-chain positivos",
  "next_update": "2026-03-21T14:45:00Z"
}

Objeto Métricas On-Chain

Análises on-chain para Bitcoin e 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"
}

Objeto Resposta de Erro

Formato padrão de resposta de erro para todos os endpoints.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Falha na validação da requisição",
    "details": [
      {
        "field": "symbol",
        "error": "Formato de par de trading inválido"
      }
    ],
    "resolution": "Use o formato como BTCUSDT"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Explore Todos os Modelos de Dados

Revise as definições completas de esquema e restrições de campos para sua integração.

Ver Referência da API REST