データモデル & スキーマリファレンス
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 | ロングまたはショート |
| 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-20倍） |
| 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生成のトレードシグナル。
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"
}
オンチェーンメトリクスオブジェクト
ビットコインとイーサリアムのオンチェーン分析。
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": "Request validation failed",
"details": [
{
"field": "symbol",
"error": "Invalid trading pair format"
}
],
"resolution": "Use format like BTCUSDT"
},
"timestamp": "2026-03-21T14:35:22Z"
}