完全なREST APIリファレンス

包括的なRESTリファレンスでSmart Money APIをマスターしましょう。暗号通貨デリバティブのインテリジェンスとウォレット追跡データのための全エンドポイント、パラメータ、認証方法、実世界の統合パターンを学びます。

概要

Smart Money APIは、Bybit、Binance、Hyperliquidの3つの主要取引所におけるリアルタイムの暗号通貨デリバティブデータにRESTfulアクセスを提供します。当社のAPIは、ウォレットポジション、資金調達レート、オープンインタレスト指標、清算データ、オンチェーンシグナルを単一の統一インターフェースに集約します。取引アルゴリズム、リスク管理システム、または市場分析ツールを構築している場合でも、REST APIはすべてのSmart Moneyインテリジェンスへの直接的なプログラムアクセスを提供します。

229以上の自動検出された取引シンボルと600以上の監視対象ウォレットを備えたAPIは、包括的な市場インテリジェンスを提供します。リアルタイムのWebSocket接続はサブ秒単位の更新を提供し、RESTエンドポイントはバッチクエリ、履歴データ取得、および大規模なポートフォリオ分析を処理します。

すべてのリクエストには有効な認証資格情報を含める必要があります。無料ティアユーザーは1日20リクエストでBTCに制限されます。Traderティア（400リクエスト/日）とProティア（4,000リクエスト/日）はすべてのシンボルと高度な機能を開放します。

認証

Smart Money APIはAPIキー認証を使用します。主要な方法は X-API-Key リクエストヘッダーです。APIキーはダッシュボードから生成できます。ブラウザ/ダッシュボードセッションでは、 Authorization: Bearer を介したセッションJWTがフォールバックとして受け入れられますが、APIクライアントは X-API-Key.

APIキー認証（主要）

すべてのリクエストでAPIキーを X-API-Key ヘッダーに含めてください。キーをURLに含めないでください。

HTTP

GET /v1/whales/events HTTP/1.1
Host: api.smartmoneyapi.com
X-API-Key: sm_your_key
Content-Type: application/json

セッションJWT（フォールバック）

ブラウザ/ダッシュボードセッションでは、セッションJWTを Authorization: Bearer （24時間有効）で渡すことができます。プログラムクライアントは X-API-Key.

Python

import requests
import json

# JWTトークンを取得
response = requests.post(
  "https://api.smartmoneyapi.com/auth/jwt",
  json={"api_key": "sk_live_abc123xyz789"}
)
token = response.json()["token"]

# 後続のリクエストでJWTを使用
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

ベースURL & エンドポイント

すべてのAPIリクエストは https://api.smartmoneyapi.comに送信されます。APIはバージョンプレフィックス付きの論理的なリソースカテゴリに整理されています。現在の安定バージョンは v1.

ベースURL: https://api.smartmoneyapi.com/api/v1

WebSocket URL: wss://ws.smartmoneyapi.com/stream

レスポンス形式

すべてのAPIレスポンスは、標準的なエンベロープ形式のJSONオブジェクトとして返されます。成功レスポンスはHTTP 200-299ステータスコードとレスポンスボディのデータを返します。エラーレスポンスには詳細なエラーメッセージと解決策の提案が含まれます。

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [
      {
        "wallet_address": "0x1234...",
        "symbol": "BTCUSDT",
        "position_size": 15.5,
        "entry_price": 42150.0,
        "current_price": 43200.5,
        "pnl": 16577.75,
        "pnl_percent": 3.91,
        "leverage": 5,
        "funding_rate": 0.00012,
        "last_updated": "2026-03-21T14:30:45Z"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 50,
    "total_pages": 1
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

ウォレットポジションエンドポイント

監視対象ウォレットの詳細なポジションを全取引所から取得します。このエンドポイントは、高価値ポジションのリアルタイムレバレッジ、エントリー価格、清算価格、および未実現P&Lを表示します。

GET /v1/whales/events PRO

パラメータ	タイプ	説明
symbol	string	取引ペア（例：BTCUSDT、ETHUSDT）任意
exchange	string	取引所でフィルタ：bybit、binance、hyperliquid 任意
min_position_size	number	ベースアセットの最小ポジションサイズ任意
direction	string	ロングまたはショートポジションのみ任意
page	integer	ページネーションページ番号、デフォルト1 任意
limit	integer	ページあたりの結果数、最大100、デフォルト50 任意

リクエスト例:

cURL

curl -X GET "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&min_position_size=10&limit=25" \
  -H "X-API-Key: sm_your_key" \
  -H "Content-Type: application/json"

資金調達レートエンドポイント

Bybit、Binance、Hyperliquidのリアルタイムおよび履歴資金調達レートにアクセスします。資金調達レートはアービトラージ取引、スイング戦略、およびデリバティブヘッジに不可欠です。当社のAPIは15分間隔でレートを集約し、履歴レート分析を提供します。

GET /v1/funding-rates FREE

パラメータ	タイプ	説明
symbol	string	取引ペア（例：BTCUSDT）必須
exchange	string	取引所：bybit、binance、hyperliquid 任意
interval	string	1h、4h、1d、デフォルト1h 任意
limit	integer	返す履歴期間、最大500 任意

リクエスト例:

JavaScript

const fetchFundingRates = async () => {
  const response = await fetch(
    "https://api.smartmoneyapi.com/v1/funding-rates?symbol=BTCUSDT&interval=4h&limit=100",
    {
      headers: {
        "X-API-Key": "sm_your_key",
        "Content-Type": "application/json"
      }
    }
  );
  const data = await response.json();
  console.log(data);
};
fetchFundingRates();

オープン・インタレスト・エンドポイント

すべてのレバレッジトレーダーにわたる総合的なオープン・インタレストを監視します。価格変動からのオープン・インタレストの乖離は、潜在的な反転やトレンド継続の機会を示唆します。絶対的なOIとOI変化率の両方を追跡します。

GET /v1/open-interest TRADER

パラメータ	タイプ	説明
symbol	string	取引ペア必須
exchange	string	bybit、binance、またはhyperliquid 任意
granularity	string	1m、5m、15m、1h、4h、1d、デフォルト15m 任意

清算エンドポイント

シンボルに対して2つの補完的なビューを返します：レバレッジ予測レベル（清算クラスターが存在すると推定される場所）と realized_heatmap — 公開取引所のWebSocketフィード（Binance、OKX、Bybit、Bitget、BitMEX）からリアルタイムで集計された実際の強制清算強度（価格×時間）。ヒートマップは、シンボルに対してデータがある場合に表示されます。

GET /v1/liquidations TRADER

パラメータ	タイプ	説明
symbol	string	資産シンボル、デフォルトBTC 任意

Trader カスケードリスク、最近の距離、および実現済み合計/サイド別を返します。 Pro 完全な予測されたレベルに加えて、完全な realized_heatmap （マトリックス、価格クラスターごと、取引所ごとのカウント）を返します。

オンチェーンDeFi清算

独自のBSCおよびAvalancheフルノードから直接キャプチャされた実行済みDeFiレンディングプロトコルの清算—任意の取引ボットから独立。BSCではVenus/CreamおよびMoolah、AvalancheではAAVE V3/V2、Benqi、BankerJoe、Granary、Viniumをカバー。認証キー（Trader+）が必要。Proはさらにボット依存のリスクポジションを返します。

GET /v1/liquidations/onchain TRADER

パラメータ	タイプ	説明
chain	string	bscまたはavax；省略するとすべて任意
limit	integer	最大行数、デフォルト100、最大500（新しい順）任意

確認エンドポイント

この /v1/confirm エンドポイントは、デリバティブ、オンチェーン（無料のCoin Metrics：MVRV / 取引所フロー / アクティブアドレス）、およびクジラのポジショニングを組み合わせたルールベースの多要素 confluence スコアを返します。この composite は-1.0から+1.0（0–100ではない）の範囲であり、すべてのレスポンスには透明な factors 内訳（各脚のスコア×重み）、 adjustments, 重み、および coverageが含まれます。これは保証された勝率ではなく、意思決定支援です。未追跡のシンボルは、捏造されたLOWではなく、明示的なNO_DATA / 未サポート結果を返します。

GET /v1/confirm TRADER

パラメータ： symbol （BTC/ETH/SOL）と direction （ロング/ショート）。 confidence はHIGH / MEDIUM / LOW / VETO / NO_DATAのいずれか； action はCONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIPのいずれか； size_mult は推奨ポジションサイズ乗数です。

オンチェーンデータエンドポイント

取引所フロー、クジラウォレットの動き、MVRV比率、NUPL、支出条件、実現ボラティリティを含むビットコインおよびイーサリアムのオンチェーン指標にアクセスします。これらの指標は蓄積/分散サイクルを特定し、主要な反転の早期シグナルを提供します。

GET /v1/on-chain/metrics PRO

パラメータ	タイプ	説明
asset	string	bitcoinまたはethereum 必須
metrics	array	特定の指標：exchange_flows、mvrv、nupl、whale_moves 任意
interval	string	1d（日次）、1w（週次）、デフォルト1d 任意

データモデルリファレンス

APIレスポンスの構造を理解することは統合に不可欠です。以下はすべてのエンドポイントで使用される完全なデータモデル定義です。

WhalePositionオブジェクト

JSON

{
  "id": "pos_1a2b3c4d5e6f7g8h",
  "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
  "exchange": "bybit",
  "symbol": "BTCUSDT",
  "position_type": "long",
  "position_size": 15.5,
  "entry_price": 42150.0,
  "current_price": 43200.5,
  "pnl": 16577.75,
  "pnl_percent": 3.91,
  "leverage": 5,
  "margin_balance": 129000.0,
  "used_margin": 126225.0,
  "available_margin": 2775.0,
  "liquidation_price": 34560.0,
  "funding_rate": 0.00012,
  "time_opened": "2026-03-15T08:30:00Z",
  "last_updated": "2026-03-21T14:30:45Z"
}

FundingRateRecordオブジェクト

JSON

{
  "timestamp": "2026-03-21T14:00:00Z",
  "symbol": "BTCUSDT",
  "bybit": {
    "funding_rate": 0.00012,
    "next_rate": 0.00015
  },
  "binance": {
    "funding_rate": 0.00010,
    "next_rate": 0.00013
  },
  "hyperliquid": {
    "funding_rate": 0.00014,
    "next_rate": 0.00016
  },
  "aggregated": {
    "mean": 0.000120,
    "median": 0.000120,
    "spread": 0.000060
  }
}

コード例

以下は、一般的な統合パターンのための本番環境対応のコード例です。

Pythonでクジラポジションを監視する

Python

import requests
import time
from typing import List, Dict

class SmartMoneyClient:
    def __init__(self, api_key: str):
        self.api_key = api_key
        self.base_url = "https://api.smartmoneyapi.com/api/v1"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }

    def get_whale_positions(self, symbol: str = None) -> Dict:
        """シンボルフィルター付きでクジラポジションを取得"""
        params = {}
        if symbol:
            params["symbol"] = symbol

        response = requests.get(
            f"{self.base_url}/whales/events",
            headers=self.headers,
            params=params
        )
        return response.json()

    def get_funding_rates(self, symbol: str) -> Dict:
        """現在および過去の資金調達レートを取得"""
        response = requests.get(
            f"{self.base_url}/funding-rates",
            headers=self.headers,
            params={"symbol": symbol, "limit": 100}
        )
        return response.json()

    def monitor_whale_activity(self, symbol: str, interval_seconds: int = 60):
        """クジラポジションを継続的に監視"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Whale {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# 使用例
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Total whale positions: {whales['data']['total']}")

ベストプラクティス & パフォーマンスのヒント

ページネーションを使用: 大きな結果セットは必ずページネーションしてください。一度にすべてのデータを取得するのではなく、limitとpageパラメータを使用して50-100レコードのチャンクでデータを取得します。

レスポンスをキャッシュ: クジラポジションは毎秒変化しません。API呼び出しを減らしパフォーマンスを向上させるため、結果を30-60秒間キャッシュします。

早期フィルタリング: アプリケーションコードでなく、クエリパラメータ（symbol、exchange、direction）を使用してサーバーサイドでデータをフィルタリングします。

レート制限の処理: 指数バックオフリトライロジックを実装します。レート制限（429ステータス）に達した場合、待機して再試行します。

リアルタイムにはWebSocketを使用: ストリーミングデータには、RESTエンドポイントのポーリングよりもWebSocket接続を優先します。帯域幅を節約し、サブ秒の遅延が得られます。

タイムスタンプを検証: すべてのタイムスタンプはISO 8601 UTC形式です。表示には常にローカルタイムゾーンに変換し、保存はUTCで行います。

切断の処理: WebSocket接続の自動再接続ロジックを指数バックオフ付きで実装します。

クォータを監視: レスポンスのX-Requests-Remainingヘッダーを確認します。API使用量を計画し、ティア制限内に収まるようにします。

一般的な統合パターン

パターン1: クジラの蓄積アラート

クジラポジションが閾値を超えて増加した場合にアラートを設定し、潜在的な強気相場や蓄積フェーズをシグナルします。

パターン2: 資金調達レートのアービトラージ検出

取引所間で資金調達レートのスプレッドが利益の出る閾値を超えた場合を自動検出し、クロス取引所アービトラージアルゴリズムを可能にします。

パターン3: 清算カスケードの監視

大規模な清算を追跡し、カスケード清算と高影響の価格変動にアルゴリズムを配置します。

パターン4: マルチシグナル確認

クジラポジション、資金調達レート、オンチェーンメトリクス、およびAI確認スコアを組み合わせて、確信度の高いエントリーシグナルを生成します。

準備はできましたか？

コンソールからAPIキーを取得し、今日から構築を開始しましょう。すべての新規アカウントは無料ティアアクセス（1日20リクエスト、BTC、ETH、SOL）を取得できます。TraderまたはProにアップグレードすると、すべてのシンボルと高度な機能に無制限にアクセスできます。

APIキーを取得

Pro機能のロックを解除

クジラポジション、確認スコア、オンチェーンデータ、および1日2000以上のAPIリクエストに完全アクセスできます。

価格を確認