24h出来高—建玉—24h清算$1.36B24hロング/ショート—BTCドミナンス—ETHドミナンス—
アプリ
言語 ▾
¥ JPY ▾
/api/hl/whale/:addr
GET利用可能

Hyperliquid単一クジラの詳細

Hyperliquid単一クジラの詳細（ポジションとアクティビティ）

GET/api/hl/whale/:addr
アドレスの保存済みスナップショットが10分より古い場合、リクエストは応答前にHyperliquidの公開APIからスナップショットを更新します。そのため、最初の呼び出しは遅くなることがあります。

リクエスト

クエリパラメータ

名前型必須デフォルト指定可能な値説明
addr pathstring必須——0xで始まる16進40桁のアドレス。形式が不正な場合は400（小文字）。 例: 0x5b5d51203a0f9079f8aeb098a6523a13f298c060

「path」と表示されたパラメータはURLの一部です。

リクエスト例

curl -s "https://www.coinboss.com/api/hl/whale/0x5b5d51203a0f9079f8aeb098a6523a13f298c060"

レスポンスフィールド

フィールド表は実際のレスポンスから生成しているため、エンドポイントが返す内容をそのまま反映しています。パスでは、配列の要素をa[]、銘柄や取引所などの動的な名前をキーとするオブジェクトを{*}で表します。

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
updatednumbermsデータが最後に更新された時刻。
addressstring—オンチェーンアドレス。
trackedboolean—アドレスが追跡対象のクジラプールに含まれる場合はtrue。
labelsarray—ラベル。
labels[]object—ラベル。
labels[].labelstring—ラベル。
labels[].typestring—種別。
profileobject—アドレスのプールレコード。追跡対象でない場合はnull。
profile.firstSeennumbermsアドレスが大口約定または清算で最初に記録された時刻。
profile.lastActivenumbermsアドレスが大口約定または清算で最後に確認された時刻。
profile.totalVolumeUsdnumberUSD`firstSeen`以降に記録された、アドレスの大口約定の累積想定元本。そのアドレスの全取引高ではありません。
profile.tradeCountnumbercount`firstSeen`以降にそのアドレスについて記録された大口約定の件数。
profile.maxFillUsdnumberUSDそのアドレスについて記録された最大の単一約定。
profile.liqCountnumbercount追跡開始以降に記録された、Hyperliquidにおけるこのアドレスの清算。
profile.sourcestring—値の取得元。
profile.accountValuenumberUSDアカウントの純資産（エクイティ）。
profile.totalUpnlnumberUSD未実現損益の合計。
profile.totalPosValuenumberUSD直近のポーリング（`posPolledAt`）時点の全保有ポジションのポジション評価額の合計。一度もポーリングされていない場合はnull。
profile.posPolledAtnumbermsポジションを最後にポーリングした時刻。
positionsarray—保有ポジション。
positions[]object—保有ポジション。
positions[].coinstring—銘柄シンボル（大文字。例：BTC）。
positions[].sidestring—`long` / `short`または`buy` / `sell`。
positions[].szinumber—符号付きのポジションサイズ（コイン数。負の値 = ショート）。
positions[].entryPxnumberUSD平均エントリー価格。
positions[].positionValuenumberUSDポジションの想定元本。
positions[].unrealizedPnlnumberUSD未実現損益。
positions[].roenumberfraction未実現損益をポジションの証拠金で割った値。Hyperliquidの報告値です（0.13 = 13 %）。ゼロまたは欠落の場合はnull。
positions[].leveragenumber—ポジションのレバレッジ。
positions[].leverageTypestring—ポジションの証拠金モード：`cross`または`isolated`。
positions[].marginUsednumberUSDポジションの使用証拠金。
positions[].liquidationPxnumber|nullUSD推定清算価格。
positions[].snapshotTsnumbermsポジションスナップショットの時刻。
recentLiquidationsarray—Hyperliquidにおけるこのアドレスの直近の清算最大50件（新しい順）。記録がない場合は空です。 この表の生成に使用したサンプルでは空
statsobject—アドレスの直近の無期限先物約定（最大2,000件）から算出した取引統計。算出されるまではnull。
stats.windowDaysnumberdays分析対象の最も古い約定と最も新しい約定の間の日数（最小1）。
stats.fillsAnalyzednumbercount分析対象の約定数：Hyperliquidがそのアドレスについて返す直近の約定で、最大2,000件。
stats.closedTradesnumbercount分析対象の無期限先物約定に含まれる決済イベント（実現損益がゼロでない約定を、トランザクションと銘柄ごとにグループ化したもの）。
stats.winsnumbercount実現損益が正の決済イベント。
stats.winRatenumberfraction`wins` ÷ `closedTrades`（0.6 = 60 %）。決済イベントがない場合はnull。
stats.realizedPnlnumberUSD分析対象の約定の実現損益の合計（手数料控除前）。
stats.feesPaidnumberUSD分析対象の無期限先物約定の取引手数料の合計。
stats.volumeUsdnumberUSD分析対象の無期限先物約定の価格 × サイズの合計。
stats.maxDrawdownnumberUSD分析対象の約定における、累積実現損益のピークからボトムまでの最大下落幅。ドローダウンがなかった場合はnull。
stats.roinumberfractionHyperliquid自身のリーダーボードに基づくアカウントの30日間リターン（0.1 = 10 %）。アドレスがそのリーダーボードに掲載されていない場合はnull。
stats.topCoinsarray—上位銘柄。
stats.topCoins[]string—上位銘柄。
stats.computedAtnumbermsタイムスタンプ。

2026-11-11 23:00 UTCに1件の実レスポンスから生成。

レスポンス例

/api/hl/whale/0x5b5d51203a0f9079f8aeb098a6523a13f298c060 · 実際のレスポンス（2026-11-13 01:38:11 UTCに取得）。 長い配列とマップは表示用に短縮しています：labelsは3件; positionsは23件。

  • {
    • "success": true,
    • "updated": 1794533891391,
    • "address": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060",
    • "tracked": true,
    • "labels": [
      • { … 2 },
      • { … 2 }
      ],
    • "profile": {
      • "firstSeen": 1784647213853,
      • "lastActive": 1794431032742,
      • "totalVolumeUsd": 1925599.62,
      • "tradeCount": 21,
      • "maxFillUsd": 207800.94,
      • "liqCount": 0,
      • "source": "bigfill",
      • "accountValue": 75541367.08,
      • "totalUpnl": 59032490.62,
      • "totalPosValue": 348201392.29,
      • "posPolledAt": 1794533771313
      },
    • "positions": [
      • { … 12 },
      • { … 12 }
      ],
    • "recentLiquidations": [],
    • "stats": {
      • "windowDays": 1,
      • "fillsAnalyzed": 2000,
      • "closedTrades": 1262,
      • "wins": 772,
      • "winRate": 0.6117,
      • "realizedPnl": 44221.53,
      • "feesPaid": 164.6835,
      • "volumeUsd": 1047900.19,
      • "maxDrawdown": 2774.11,
      • "roi": 0.808717,
      • "topCoins": [ … 5 ],
      • "computedAt": 1793024816450
      }
    }

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
20s
エッジマイクロキャッシュ
10s
更新頻度
上位アドレスのポジションは5 minごと。10 minより古い場合はリクエスト時に更新。APIキャッシュ20 s
ウィンドウ
最新のポジション。清算履歴は保存済みのもの
データソース
Hyperliquidアドレス1つのプロファイルです。ポジション（公式info APIからポーリングし、鮮度切れの場合はリクエスト時に更新）、自社ノードに基づく清算履歴、統計、ラベルを含みます。
取引所カバレッジ
任意のアドレス。追跡対象プールに登録済みのアドレスでは、より詳しいデータを返します
ページネーション
なし
単位
USD
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版

ライブステータス

利用可能2026-11-13 01:38:11 UTCにチェックHTTP 2004 msスキーマ一致最新データポイントは0s前

可用性（過去30日間）

381回のチェック中99.74%が合格

エラー

失敗した呼び出しは、すべてのエンドポイントで共通の形式で返されます。一覧はエラーページにあります。 エラーとレート制限 →

コードHTTP意味対処方法
INVALID_PARAM400必須パラメータが不足しているか、値が受け付けられません。該当するパラメータが特定できる場合は、`param`にその名前が入ります。そのまま再試行せず、リクエストを修正してください。
UNAUTHORIZED401`CB-API-KEY`ヘッダーが送信されましたが、キーが不明か失効済みです。公開データにキーは不要です。ヘッダーを外すか、有効なキーを使用してください。そのまま再試行しないでください。
FORBIDDEN403このルートは公開APIに含まれません（内部用またはアカウント専用）。再試行しないでください。
NOT_FOUND404不明なルートであるか、リクエストされた銘柄 / 取引所 / ファンドが存在しません。再試行せず、パスと識別子をカタログと照合してください。
RATE_LIMITED429リクエスト数が1分あたりの上限を超えました。`Retry-After`に待機すべき秒数が示されます。`Retry-After`で示された時間だけ待ってから、バックオフ付きで再試行してください。
INTERNAL500予期しないサーバーエラーです。メッセージは意図的に汎用的な内容にしています。報告の際は`request_id`を引用してください。数秒後に1回だけ再試行してください。解消しない場合は、リクエストIDを添えて報告してください。
UPSTREAM_FAILED503このエンドポイントの背後にあるデータソースが時間内に応答しませんでした。鮮度切れの数値や代替の数値を代わりに返すことはありません。バックオフ付きで再試行し、ステータスページを確認してください。
UNAVAILABLE501 / 503データセットが一時的に準備できていない（キャッシュのウォームアップ中）か、このエンドポイントに適法な公開ソースがまだありません。時間をおいて再試行してください。仕様上利用できないエンドポイントは、カタログに明示されています。
REQUEST_FAILED200一部の古いエンドポイントは、HTTP 200で`success: false`を返します。HTTPステータスだけでなく、必ず`success`を確認してください。メッセージによって異なります。失敗したリクエストとして扱ってください。

試してみる

GET/api/hl/whale/:addr利用可能
パラメータ

string — 0x-prefixed 40-hex address; 400 on bad format (lowercase).

リクエストURLhttps://www.coinboss.com/api/hl/whale/0x5b5d51203a0f9079f8aeb098a6523a13f298c060
エンドポイントを選択して「リクエストを送信」を押してください。レスポンス、ヘッダー、所要時間がここに表示されます。