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

1つの伝統金融シンボルの清算概要

1つの伝統金融シンボルの清算概要

GET/api/liquidations/tradfi-symbol

リクエスト

クエリパラメータ

名前型必須デフォルト指定可能な値説明
symbolstring必須——伝統金融シンボル（エイリアス可）。解決できない場合は400。清算履歴がない場合は404。 例: SNDK

リクエスト例

curl -s "https://www.coinboss.com/api/liquidations/tradfi-symbol?symbol=SNDK"

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
nownumbermsレスポンスを生成した時点のサーバー時刻。
symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
is_alias_inputboolean—リクエストされた`symbol`がエイリアスで、別の正規シンボルに対応付けられた場合はtrue。
canonical_symbolstring—この原資産のすべてのエイリアスが集約される正規シンボル。`symbol`と同じ値です。
merged_fromarray—この行に統合されたソース。
merged_from[]string—この行に統合されたソース。
display_namestring—表示名。
contract_namestring—この原資産のトークン化契約について登録されている名称。不明な場合は空文字列。
contract_typestring—`perpetual`または`delivery`。
asset_classstring—`stock`、`index`、`commodity`、`forex`のいずれか。
subclassesarray—このシンボルの清算レコードに見つかった資産サブクラスタグ（重複を除く）。
subclasses[]string—資産サブクラスタグ1件（例：`common_stock`、`unspecified`）。
exchangesarray—取引所。
exchanges[]string—取引所。
dexesarray—分散型取引所。
dexes[]string—分散型取引所。
first_tsnumbermsタイムスタンプ。
last_tsnumbermsタイムスタンプ。
cnt_30dnumbercount直近30日間におけるこのシンボルの清算レコード数。
tierstring—`cnt_30d`に基づくアクティビティティア：`T1` ≥ 1000、`T2` 200–999、`T3` 50–199、`T4` 10–49、10未満は`none`。
min_cnt_30dnumbercountシンボルがシンボルディレクトリに掲載されるために必要な、30日間の清算件数の下限（10）。
overviewobject—概要ブロック。 動的キー: 1h,4h,12h,24h,7d,30d
overview.{*}object—概要ブロック。
overview.{*}.long_usdnumberUSDロング側。
overview.{*}.short_usdnumberUSDショート側。
overview.{*}.total_usdnumberUSD合計。
overview.{*}.cntnumber—件数。
class_evidencearray—シンボルの資産クラス割り当ての根拠のうち、出現頻度の高いもの最大3件（頻度の高い順）。
class_evidence[]object—根拠のエントリー1件：`source`、`evidence`文字列、それを持つレコード数（`cnt`）。
class_evidence[].sourcestring—値の取得元。
class_evidence[].evidencestring—清算とともに記録された、分類根拠の生の文字列（例：`desc:common_stock`）。
class_evidence[].cntnumber—件数。

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

レスポンス例

/api/liquidations/tradfi-symbol?symbol=SNDK · 実際のレスポンス（2026-11-13 03:58:43 UTCに取得）。 長い配列とマップは表示用に短縮しています：overviewは6件; exchangesは9件。

  • {
    • "success": true,
    • "now": 1794542323216,
    • "symbol": "SNDK",
    • "is_alias_input": false,
    • "canonical_symbol": "SNDK",
    • "merged_from": [
      • "SNDK"
      ],
    • "display_name": "Sandisk",
    • "contract_name": "Sandisk",
    • "contract_type": "stock",
    • "asset_class": "stock",
    • "subclasses": [
      • "common_stock",
      • "unspecified"
      ],
    • "exchanges": [
      • "aster",
      • "binance",
      • "bitget",
      • "bybit",
      • "gate",
      • "htx",
      • "hyperliquid",
      • "lighter"
      ],
    • "dexes": [
      • "io",
      • "xyz"
      ],
    • "first_ts": 1781766257143,
    • "last_ts": 1794542028089,
    • "cnt_30d": 55476,
    • "tier": "T1",
    • "min_cnt_30d": 10,
    • "overview": {
      • "1h": { … 4 },
      • "4h": { … 4 }
      },
    • "class_evidence": [
      • { … 3 }
      ]
    }

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
20s
エッジマイクロキャッシュ
10s
更新頻度
リアルタイム（取引所のWebSocketプッシュ）。RESTポーリング：okxは15 sごと、gateは25 sごと、htxは5 minごと。hyperliquidノードの約定バッチは5 sごとに取り込み
ウィンドウ
1シンボルのローリングウィンドウ：1 h、4 h、12 h、24 h、7 d、30 d
データソース
暗号資産以外の無期限先物契約（トークン化株式、指数、コモディティ、為替）の清算です。10取引所（例：binance、okx、hyperliquid、gate、bybit、bitget）を対象とする同じ自社の取引所清算コレクターで取得し、資産クラス分類器で切り分けています。
取引所カバレッジ
過去30日間に観測された10取引所（binance、okx、hyperliquid、gate、bybit、bitget、lighter、aster、htx、bitfinex）。資産クラスはstock / index / commodity / forex（ごく一部は「unknown」に分類）。履歴は2026-06-17から
単位
USD notional (price x quantity) per liquidation order; timestamps in Unix ms; side LONG = long position liquidated, SHORT = short position liquidated
算出方法
per window: long_usd, short_usd, total_usd = SUM(value_usd), cnt; tier from the 30-day event count (T1 >= 1000, T2 200-999, T3 50-199, T4 10-49, none < 10)
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版

ライブステータス

利用可能2026-11-13 03:58:43 UTCにチェックHTTP 200866 msスキーマ一致最新データポイントは5m前

可用性（過去30日間）

409回のチェック中100%が合格

エラー

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

コード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/liquidations/tradfi-symbol利用可能
パラメータ

string — TradFi symbol (aliases accepted); 400 if it cannot be resolved; 404 when no liquidation history.

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