Veri Modelleri & Şema Referansı

Smart Money API veri modelleri için tam referans. Balina pozisyonları, fonlama oranları, likidasyonlar ve AI onay skorları dahil tüm yanıt nesnelerinin yapısını ve alan tanımlarını öğrenin.

Genel Bakış

API yanıt yapılarını anlamak entegrasyonlar oluşturmak için çok önemlidir. Bu referans, tüm veri modeli tanımlarını, alan türlerini, kısıtlamalarını ve örnekleri belgeler. Tüm zaman damgaları ISO 8601 UTC formatındadır. Tüm fiyatlar ve miktarlar kayan nokta hassasiyet kaybını önlemek için string olarak döndürülür.

Balina Pozisyonu Nesnesi

Kaldıraçlı ticaret borsasında izlenen bir balina cüzdanı tarafından tutulan büyük bir pozisyonu temsil eder.

Alan	Tür	Açıklama
id	string	Benzersiz pozisyon tanımlayıcısı
wallet_address	string	Balina cüzdan adresi (0x... formatı)
exchange	string	bybit, binance veya hyperliquid
symbol	string	İşlem çifti (BTCUSDT, ETHUSDT, vb.)
position_type	string	uzun veya kısa
position_size	string	Temel varlıktaki boyut (örn., BTC)
entry_price	string	Ortalama giriş fiyatı (USDT cinsinden)
current_price	string	Güncel işaret fiyatı (USDT cinsinden)
liquidation_price	string	Pozisyonun likide edileceği fiyat
pnl	string	Gerçekleşmemiş K&Z (USDT cinsinden)
pnl_percent	number	Gerçekleşmemiş K&Z yüzdesi
leverage	integer	Kaldıraç çarpanı (1-20x)
margin_balance	string	Toplam marj bakiyesi (USDT cinsinden)
used_margin	string	Kullanılan marj (USDT cinsinden)
available_margin	string	Kullanılabilir marj (USDT cinsinden)
margin_ratio	number	Kullanılabilir marj / kullanılan marj oranı
funding_rate	string	Güncel fonlama oranı (saatlik %)
time_opened	string	Açıldığı zamanın ISO 8601 zaman damgası
last_updated	string	Son güncellemenin ISO 8601 zaman damgası

Örnek Balina Pozisyonu

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

Fonlama Oranı Nesnesi

Tek bir sembol ve zaman dilimi için birden fazla borsadaki fonlama oranlarını temsil eder.

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

Likidasyon Nesnesi

Kaldıraçlı bir pozisyonun zorla likide edilmesini temsil eder.

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

Açık Pozisyon Nesnesi

Tüm kaldıraçlı tüccarların toplam açık pozisyonunu temsil eder.

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

Onay Skoru Nesnesi

Balina pozisyonları, on-chain veriler, fonlama oranları ve piyasa duyarlılığını birleştiren AI tarafından oluşturulan ticaret sinyali.

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": "Büyük balina birikimi ve pozitif on-chain sinyaller",
  "next_update": "2026-03-21T14:45:00Z"
}

On-Chain Metrikler Nesnesi

Bitcoin ve Ethereum için on-chain analitikler.

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

Hata Yanıtı Nesnesi

Tüm endpoint'ler için standart hata yanıt formatı.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "İstek doğrulaması başarısız oldu",
    "details": [
      {
        "field": "symbol",
        "error": "Geçersiz işlem çifti formatı"
      }
    ],
    "resolution": "BTCUSDT gibi bir format kullanın"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Tüm Veri Modellerini Keşfet

Entegrasyonunuz için tam şema tanımlarını ve alan kısıtlamalarını inceleyin.

REST API Referansını Görüntüle