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

データ品質マトリックス（コレクター視点）

自社データ層：データ品質マトリックス（取引所 × データ種別）

GET/api/sd/quality

リクエスト

このエンドポイントにパラメータはありません。

リクエスト例

curl -s "https://www.coinboss.com/api/sd/quality"

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
nownumbermsレスポンスを生成した時点のサーバー時刻。
familiesarray—すべての取引所についてチェックするデータ種別（表示順）。
families[]string—データ種別のID：`ticker`、`oi`、`funding`、`funding_settle`、`liquidation`、`ls`、`spot`、`sd_contracts`のいずれか。
exchangesarray—取引所。
exchanges[]string—取引所。
matrixobject—行と列をキーとするマトリックス。 動的キー: aster,backpack,binance,bingx,bitfinex,bitget
matrix.{*}object—行と列をキーとするマトリックス。 動的キー: ticker,oi,funding,funding_settle,liquidation,ls
matrix.{*}.tickerobject—取引所の先物ティッカーの鮮度：`status`、行数、`age_s`、鮮度内/利用可能の各ウィンドウ。マップのキーは取引所IDです。 省略される場合あり
matrix.{*}.ticker.statusstring—ステータス。 省略される場合あり
matrix.{*}.ticker.rowsnumber—結果の行。 省略される場合あり
matrix.{*}.ticker.rows_freshnumber—鮮度ウィンドウ内に更新された行。 省略される場合あり
matrix.{*}.ticker.rows_usablenumber—利用可能ウィンドウ内の行。 省略される場合あり
matrix.{*}.ticker.rows_orphannumber—契約がすでに上場廃止となっている行。 省略される場合あり
matrix.{*}.ticker.rows_invalidnumber—妥当性チェックで不合格となった行。 省略される場合あり
matrix.{*}.ticker.age_snumbersこの行が最後に更新されてからの経過秒数。 省略される場合あり
matrix.{*}.ticker.fresh_within_snumbers鮮度ウィンドウ：これより新しいデータは鮮度内とみなされます。 省略される場合あり
matrix.{*}.ticker.usable_within_snumbersこれより古いデータは一切使用されません。 省略される場合あり
matrix.{*}.oiobject—建玉。 省略される場合あり
matrix.{*}.oi.statusstring—ステータス。 省略される場合あり
matrix.{*}.oi.rowsnumber—結果の行。 省略される場合あり
matrix.{*}.oi.rows_freshnumber—鮮度ウィンドウ内に更新された行。 省略される場合あり
matrix.{*}.oi.rows_usablenumber—利用可能ウィンドウ内の行。 省略される場合あり
matrix.{*}.oi.rows_orphannumber—契約がすでに上場廃止となっている行。 省略される場合あり
matrix.{*}.oi.rows_invalidnumber—妥当性チェックで不合格となった行。 省略される場合あり
matrix.{*}.oi.age_snumbersこの行が最後に更新されてからの経過秒数。 省略される場合あり
matrix.{*}.oi.fresh_within_snumbers鮮度ウィンドウ：これより新しいデータは鮮度内とみなされます。 省略される場合あり
matrix.{*}.oi.usable_within_snumbersこれより古いデータは一切使用されません。 省略される場合あり
matrix.{*}.fundingobject—資金調達率のブロックまたは値。 省略される場合あり
matrix.{*}.funding.statusstring—ステータス。 省略される場合あり
matrix.{*}.funding.rowsnumber—結果の行。 省略される場合あり
matrix.{*}.funding.rows_freshnumber—鮮度ウィンドウ内に更新された行。 省略される場合あり
matrix.{*}.funding.rows_usablenumber—利用可能ウィンドウ内の行。 省略される場合あり
matrix.{*}.funding.rows_orphannumber—契約がすでに上場廃止となっている行。 省略される場合あり
matrix.{*}.funding.rows_invalidnumber—妥当性チェックで不合格となった行。 省略される場合あり
matrix.{*}.funding.age_snumbersこの行が最後に更新されてからの経過秒数。 省略される場合あり
matrix.{*}.funding.fresh_within_snumbers鮮度ウィンドウ：これより新しいデータは鮮度内とみなされます。 省略される場合あり
matrix.{*}.funding.usable_within_snumbersこれより古いデータは一切使用されません。 省略される場合あり
matrix.{*}.funding.rows_unknown_intervalnumbercount直近4時間に更新された資金調達率の行のうち、決済間隔が不明なため8時間に正規化できないもの。このような行が1つでもあると、セルは`partial`になります。 省略される場合あり
matrix.{*}.funding.rows_no_next_timenumbermsタイムスタンプ。 省略される場合あり
matrix.{*}.funding.rows_no_livenessnumbercount実際に取引されている形跡がない契約（上場廃止または出来高なし）の、最近更新された資金調達率の行。鮮度のカウントからは除外されます。 省略される場合あり
matrix.{*}.funding_settleobject—取引所の資金調達決済履歴の鮮度：`status`、最新の決済の`age_s`、`symbols`、`history_from`。 省略される場合あり
matrix.{*}.funding_settle.statusstring—ステータス。 省略される場合あり
matrix.{*}.funding_settle.age_snumbersこの行が最後に更新されてからの経過秒数。 省略される場合あり
matrix.{*}.funding_settle.symbolsnumber—シンボル。 省略される場合あり
matrix.{*}.funding_settle.history_fromnumberms保持している最も古い記録。 省略される場合あり
matrix.{*}.funding_settle.fresh_within_snumbers鮮度ウィンドウ：これより新しいデータは鮮度内とみなされます。 省略される場合あり
matrix.{*}.liquidationobject—清算のブロック。 省略される場合あり
matrix.{*}.liquidation.statusstring—ステータス。 省略される場合あり
matrix.{*}.liquidation.viastring—取得経路。 省略される場合あり
matrix.{*}.liquidation.last_event_age_snumber|nullsイベントからの経過秒数。 省略される場合あり
matrix.{*}.liquidation.events_1hnumbercount直近1時間にこの取引所から保存された清算注文。最小注文サイズは取引所によって異なるため、件数を相互に比較することはできません。 省略される場合あり
matrix.{*}.liquidation.events_24hnumbercount直近24時間にこの取引所から保存された清算注文。最小注文サイズは取引所によって異なるため、件数を相互に比較することはできません。 省略される場合あり
matrix.{*}.liquidation.ws_heartbeat_age_snumber|nullsイベントからの経過秒数。 省略される場合あり
matrix.{*}.liquidation.judged_bystring—ステータスの判定に使用したタイムスタンプ。 省略される場合あり
matrix.{*}.liquidation.idle_ok_snumbersこの取引所で正常と見なされる、清算が発生しない最長の間隔。これより長い間隔が空くと、フィードは`stale`になります。 省略される場合あり
matrix.{*}.lsobject—取引所のロング/ショート比率の行の鮮度：`status`、行数、`age_s`、鮮度内/利用可能の各ウィンドウ。 省略される場合あり
matrix.{*}.ls.statusstring—ステータス。 省略される場合あり
matrix.{*}.ls.reasonstring—理由コード。 省略される場合あり
matrix.{*}.spotobject—現物市場のブロックまたは値。 省略される場合あり
matrix.{*}.spot.statusstring—ステータス。 省略される場合あり
matrix.{*}.spot.reasonstring—理由コード。 省略される場合あり
matrix.{*}.sd_contractsobject—取引所のコイン証拠金型、USDC建て、限月先物の各契約行の鮮度：`status`、行数、`age_s`。 省略される場合あり
matrix.{*}.sd_contracts.statusstring—ステータス。 省略される場合あり
matrix.{*}.sd_contracts.reasonstring—理由コード。 省略される場合あり
matrix.{*}.funding_settle.reasonstring—理由コード。 省略される場合あり
matrix.{*}.liquidation.reasonstring—理由コード。 省略される場合あり
matrix.{*}.liquidation.notestring—備考。 省略される場合あり
matrix.{*}.ls.rowsnumber—結果の行。 省略される場合あり
matrix.{*}.ls.rows_freshnumber—鮮度ウィンドウ内に更新された行。 省略される場合あり
matrix.{*}.ls.rows_usablenumber—利用可能ウィンドウ内の行。 省略される場合あり
matrix.{*}.ls.rows_orphannumber—契約がすでに上場廃止となっている行。 省略される場合あり
matrix.{*}.ls.rows_invalidnumber—妥当性チェックで不合格となった行。 省略される場合あり
matrix.{*}.ls.age_snumbersこの行が最後に更新されてからの経過秒数。 省略される場合あり
matrix.{*}.ls.fresh_within_snumbers鮮度ウィンドウ：これより新しいデータは鮮度内とみなされます。 省略される場合あり
matrix.{*}.ls.usable_within_snumbersこれより古いデータは一切使用されません。 省略される場合あり
matrix.{*}.spot.age_snumbersこの行が最後に更新されてからの経過秒数。 省略される場合あり
matrix.{*}.spot.coinsnumber—銘柄。 省略される場合あり
matrix.{*}.spot.fresh_within_snumbers鮮度ウィンドウ：これより新しいデータは鮮度内とみなされます。 省略される場合あり
matrix.{*}.spot.notestring—備考。 省略される場合あり
matrix.{*}.sd_contracts.rowsnumber—結果の行。 省略される場合あり
matrix.{*}.sd_contracts.rows_freshnumber—鮮度ウィンドウ内に更新された行。 省略される場合あり
matrix.{*}.sd_contracts.age_snumbersこの行が最後に更新されてからの経過秒数。 省略される場合あり
matrix.{*}.sd_contracts.rows_without_oinumbercountUSD建ての建玉の値を持たない契約行。 省略される場合あり
matrix.{*}.sd_contracts.rows_oi_promotednumbercount建玉がサイト全体の建玉合計にも算入されている契約行。 省略される場合あり
matrix.{*}.sd_contracts.fresh_within_snumbers鮮度ウィンドウ：これより新しいデータは鮮度内とみなされます。 省略される場合あり
matrix.{*}.{*}object—行と列をキーとするマトリックス。
matrix.{*}.{*}.statusstring—ステータス。
matrix.{*}.{*}.reasonstring—理由コード。 省略される場合あり
matrix.{*}.{*}.age_snumbersこの行が最後に更新されてからの経過秒数。 省略される場合あり
matrix.{*}.{*}.coinsnumber—銘柄。 省略される場合あり
matrix.{*}.{*}.fresh_within_snumbers鮮度ウィンドウ：これより新しいデータは鮮度内とみなされます。 省略される場合あり
matrix.{*}.{*}.notestring—備考。 省略される場合あり
matrix.{*}.oi.reasonstring—理由コード。 省略される場合あり
matrix.{*}.{*}.rowsnumber—結果の行。 省略される場合あり
matrix.{*}.{*}.rows_freshnumber—鮮度ウィンドウ内に更新された行。 省略される場合あり
matrix.{*}.{*}.rows_usablenumber—利用可能ウィンドウ内の行。 省略される場合あり
matrix.{*}.{*}.rows_orphannumber—契約がすでに上場廃止となっている行。 省略される場合あり
matrix.{*}.{*}.rows_invalidnumber—妥当性チェックで不合格となった行。 省略される場合あり
matrix.{*}.{*}.usable_within_snumbersこれより古いデータは一切使用されません。 省略される場合あり
matrix.{*}.ticker.deadboolean—`status`が`stale`の場合にのみ含まれます。利用可能ウィンドウ内の行も存在せず、取引所が集計から除外されている場合はtrue。 省略される場合あり
matrix.{*}.funding.reasonstring—理由コード。 省略される場合あり
matrix.{*}.liquidation.pipeline_last_event_age_snumbersイベントからの経過秒数。 省略される場合あり
matrix.{*}.liquidation.node_heartbeat_age_snumbersイベントからの経過秒数。 省略される場合あり
summaryobject—概要ブロック。
summary.freshnumbercountステータスが`fresh`の取引所 × データ種別のセル数。
summary.partialnumber—想定されるデータの一部しか存在しない場合はtrue。
summary.stalenumber—鮮度ウィンドウより古いデータの行、またはそのフラグ。
summary.invalidnumbercountステータスが`invalid`の取引所 × データ種別のセル数。
summary.unavailablenumber—データが利用できない項目とその理由。0として報告されることはありません。
sourcesarray—データソース。
sources[]object—データソース。
sources[].exchangestring—取引所ID（小文字。例：`binance`）。
sources[].familystring—ヘルスレコードが属するコレクタージョブのデータ種別。例：`oi`、`funding`、`ticker`。
sources[].endpointstring—追跡している上流呼び出しのラベル：ポーリング対象の公開APIのホストとパス、または内部チェックの名称。
sources[].okboolean—直近の試行が失敗した場合（最後のエラーが最後の成功より新しい場合）はfalse。
sources[].last_ok_age_snumber|nullsイベントからの経過秒数。
sources[].last_err_age_snumber|nullsイベントからの経過秒数。
sources[].last_statusnumber—直近の呼び出しのHTTPステータス。
sources[].last_errorstring|null—直近の失敗のエラーテキスト（160文字に切り詰め）。記録がない場合はnull。
sources[].last_msnumberms直近の呼び出しの所要時間。計測されなかった場合はnull。
sources[].fail_streaknumbercount現在までの連続失敗回数。成功後は0。
sources[].ok_countnumbercountヘルスログに記録された成功した呼び出しの数。
sources[].err_countnumbercountヘルスログに記録された失敗した呼び出しの数。
sources[].http_429numbercountHTTP 429（レート制限）が返された失敗呼び出しの数。
sources[].http_403numbercountHTTP 403（アクセス禁止）が返された失敗呼び出しの数。
sources[].http_5xxnumbercountHTTP 5xxステータスが返された失敗呼び出しの数。
sources[].timeoutsnumbercountタイムアウトした失敗呼び出しの数。
errorsobject—チェック自体が失敗したデータ種別について、データ種別IDからエラーメッセージへのマップ。すべてのチェックが実行された場合は空です。
alertsarray—データ品質巡回のアラートのうち、未解決のもの、または直近24時間に解決されたもの。未解決のものが先頭です（最大200件）。
alerts[]object—アラート1件：`level`、`exchange`、`family`、`code`、`detail`、発生/最終確認/解決の各時刻、`hits`、`open`。
alerts[].levelstring—レベル。
alerts[].exchangestring—取引所ID（小文字。例：`binance`）。
alerts[].familystring—アラートの対象となるデータ種別。
alerts[].codestring—コード。
alerts[].detailstring—詳細。
alerts[].opened_atnumbermsタイムスタンプ。
alerts[].last_seen_atnumbermsタイムスタンプ。
alerts[].resolved_atnumber|nullmsタイムスタンプ。
alerts[].hitsnumbercountアラートの発生以降、その状態を検出した巡回の実行回数（5分ごとに1回）。
alerts[].openboolean—期間の始値。
monitorobject—監視自体のヘルス：最後の巡回実行からの経過時間、コレクターのハートビートからの経過時間、`patrol_ok`。
monitor.alert_job_age_snumbersイベントからの経過秒数。
monitor.collector_heartbeat_age_snumbersイベントからの経過秒数。
monitor.patrol_okboolean—巡回が直近15分以内に実行された場合はtrue。falseの場合、`alerts`リストは古くなっている可能性があります。
legendobject—各セルステータスの定義（平文）。
legend.freshstring—ステータス`fresh`の定義。
legend.partialstring—想定されるデータの一部しか存在しない場合はtrue。
legend.stalestring—鮮度ウィンドウより古いデータの行、またはそのフラグ。
legend.invalidstring—ステータス`invalid`の定義。
legend.unavailablestring—データが利用できない項目とその理由。0として報告されることはありません。

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

レスポンス例

/api/sd/quality · 実際のレスポンス（2026-11-13 03:59:27 UTCに取得）。 長い配列とマップは表示用に短縮しています：alertsは3件; matrixは29件; sourcesは262件; exchangesは29件。

  • {
    • "success": true,
    • "now": 1794542357043,
    • "families": [
      • "ticker",
      • "oi",
      • "funding",
      • "funding_settle",
      • "liquidation",
      • "ls",
      • "spot",
      • "sd_contracts"
      ],
    • "exchanges": [
      • "aster",
      • "backpack",
      • "binance",
      • "bingx",
      • "bitfinex",
      • "bitget",
      • "bitstamp",
      • "bitunix"
      ],
    • "matrix": {
      • "aster": { … 8 },
      • "backpack": { … 8 }
      },
    • "summary": {
      • "fresh": 123,
      • "partial": 7,
      • "stale": 1,
      • "invalid": 0,
      • "unavailable": 101
      },
    • "sources": [
      • { … 16 },
      • { … 16 }
      ],
    • "errors": {},
    • "alerts": [
      • { … 10 },
      • { … 10 }
      ],
    • "monitor": {
      • "alert_job_age_s": 20,
      • "collector_heartbeat_age_s": 17,
      • "patrol_ok": true
      },
    • "legend": {
      • "fresh": "data timestamps within the fresh window",
      • "partial": "some rows outside the fresh window or missing a required field",
      • "stale": "no row within the fresh window (dead=true: also outside the usable window, excluded from aggregates)",
      • "invalid": "more than half of usable rows fail sanity checks",
      • "unavailable": "no public source or not collected; shown as —, never 0"
      }
    }

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
20s
エッジマイクロキャッシュ
10s
更新頻度
マトリックスはリクエスト時に算出（プロセス内メモ化20 s）。アラートジョブは5 minごと
ウィンドウ
最新の状態。アラートは未解決のもの、または直近24 h以内に解決されたもの
データソース
データ鮮度マトリックス（取引所 × データ種別）です。CoinBossが自社で収集したテーブルのタイムスタンプから算出しています。
取引所カバレッジ
収集対象のいずれかのデータ種別に存在するすべての取引所。欠落しているソースは、理由付きでunavailableとして報告されます
ページネーション
アラートは最大200件
単位
status per cell: fresh | partial | stale | invalid | unavailable; ages in seconds
算出方法
fresh = >= 90% of live rows inside the family's freshness window (tickers 5 min, OI 15 min / cme 36 h, funding 15 min, long/short 90 min); liquidation feeds judged by WebSocket heartbeat or time since last event; funding settlements fresh within 9 h; spot snapshots within 30 min
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版
提供開始
2026-11-11

ライブステータス

利用可能2026-11-13 03:59:27 UTCにチェックHTTP 2006 msスキーマ一致最新データポイントは20s前

可用性（過去30日間）

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

直近のプローブで検出されたスキーマのずれ
  • 返されているがドキュメントに未記載: matrix.{*}.{*}.rows_unknown_interval, matrix.{*}.{*}.rows_no_next_time, matrix.{*}.{*}.rows_no_liveness, matrix.{*}.{*}.symbols, matrix.{*}.{*}.history_from, matrix.{*}.{*}.via, matrix.{*}.{*}.last_event_age_s, matrix.{*}.{*}.events_1h, matrix.{*}.{*}.events_24h, matrix.{*}.{*}.ws_heartbeat_age_s, matrix.{*}.{*}.judged_by, matrix.{*}.{*}.idle_ok_s

エラー

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

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

パラメータはありません。

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