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

データ品質マトリックス

取引所 × データ種別のマトリックスです。FRESH / PARTIAL / STALE / BROKEN / UNAVAILABLEの判定、ソースと取得のタイムスタンプ、遅延、カバレッジ、各欠損の理由が含まれます。

GET/api/meta/quality

リクエスト

クエリパラメータ

名前型必須デフォルト指定可能な値説明
exchangestring任意——この取引所のみを返します（小文字のID。例：`binance`）。
familystring任意——このデータ種別のみを返します（例：`oi`、`funding`、`liquidation`）。

リクエスト例

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

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
schemastring—このレスポンスのスキーマID（`coinboss.meta.quality/1`）。
nownumbermsレスポンスを生成した時点のサーバー時刻。
familiesarray—取引所ごとに評価するデータ種別（ティッカー、建玉、資金調達率、清算、板、オプションなど）。
families[]object—1データ種別分：`id`、`scope`、`title`、`what`、`table`、`cadence`、`fresh_within_s`。
families[].idstring—識別子。
families[].scopestring—`matrix`で取引所ごとに評価されるデータ種別の場合は`exchange`。
families[].titlestring—データ種別の表示タイトル。
families[].whatstring—そのデータ種別が対象とするデータの簡単な説明。
families[].tablestring—そのデータ種別の評価に使用する内部データセットの名前。参考情報です。
families[].cadencestring—そのデータ種別の収集スケジュール（平文）。記載がない場合はnull。
families[].fresh_within_snumbers鮮度ウィンドウ：これより新しいデータは鮮度内とみなされます。
exchangesarray—取引所。
exchanges[]string—取引所。
matrixobject—行と列をキーとするマトリックス。 動的キー: aster,backpack,binance,bingx,bitfinex,bitget
matrix.{*}object—行と列をキーとするマトリックス。 動的キー: ticker,oi,funding,funding_settle,liquidation,ls
matrix.{*}.{*}object—行と列をキーとするマトリックス。
matrix.{*}.{*}.statusstring—ステータス。
matrix.{*}.{*}.lag_snumber|nulls現在時刻から、その取引所（1番目のキー）とデータ種別（2番目のキー）の最新の保存済みデータのタイムスタンプを引いた値。そのデータ種別がその取引所で利用できない場合はnull。
matrix.{*}.{*}.source_atnumber|nullmsタイムスタンプ。
matrix.{*}.{*}.fetched_atnumber|nullmsCoinBossがソースからデータを取得した時刻。
matrix.{*}.{*}.fresh_within_snumber|nulls鮮度ウィンドウ：これより新しいデータは鮮度内とみなされます。
matrix.{*}.{*}.coverageobject|null—含まれているものと欠けているもの。
matrix.{*}.{*}.coverage.rowsnumber—結果の行。 省略される場合あり
matrix.{*}.{*}.coverage.rows_freshnumber—鮮度ウィンドウ内に更新された行。 省略される場合あり
matrix.{*}.{*}.coverage.rows_usablenumber—利用可能ウィンドウ内の行。 省略される場合あり
matrix.{*}.{*}.coverage.rows_orphannumber—契約がすでに上場廃止となっている行。 省略される場合あり
matrix.{*}.{*}.coverage.rows_invalidnumber—妥当性チェックで不合格となった行。 省略される場合あり
matrix.{*}.{*}.reasonstring|null—理由コード。
matrix.{*}.{*}.coverage.rows_no_livenessnumbercount実際に取引されている形跡がない契約（上場廃止または出来高なし）の資金調達率の行。鮮度のカウントからは除外されます。 省略される場合あり
matrix.{*}.{*}.coverage.rows_unknown_intervalnumbercount最近更新された資金調達率の行のうち、決済間隔が不明なため8時間に正規化できないもの。 省略される場合あり
matrix.{*}.{*}.coverage.symbolsnumber—シンボル。 省略される場合あり
matrix.{*}.{*}.coverage.events_1hnumbercount直近1時間にその取引所から保存された清算注文。最小注文サイズは取引所によって異なります。 省略される場合あり
matrix.{*}.{*}.coverage.events_24hnumbercount直近24時間にその取引所から保存された清算注文。最小注文サイズは取引所によって異なります。 省略される場合あり
matrix.{*}.{*}.viastring—取得経路。 省略される場合あり
matrix.{*}.{*}.coverage.booksnumbercount追跡対象の板の数。 省略される場合あり
matrix.{*}.{*}.coverage.books_freshnumbercount鮮度ウィンドウ内に更新された板の数。 省略される場合あり
matrix.{*}.{*}.coverage.books_reaching_2pctnumbercount仲値の±2 %をカバーできる厚みのある板の数。 省略される場合あり
matrix.{*}.{*}.coverage.contractsnumber—契約ごとの行。 省略される場合あり
matrix.{*}.{*}.coverage.contracts_freshnumbercount鮮度ウィンドウ内に更新された契約の数。 省略される場合あり
matrix.{*}.{*}.coverage.with_mark_and_indexnumbercountマーク価格とインデックス価格の両方を持つ契約の数。 省略される場合あり
matrix.{*}.{*}.coverage.delivery_contractsnumbercount限月先物（満期日のある契約）の数。 省略される場合あり
matrix.{*}.{*}.notestring—備考。 省略される場合あり
matrix.{*}.{*}.coverage.coinsnumber—銘柄。 省略される場合あり
matrix.{*}.{*}.coverage.rows_without_oinumbercountUSD建ての建玉の値を持たない、コイン証拠金型、USDC建て、または限月先物の契約行。 省略される場合あり
matrix.{*}.{*}.coverage.with_mark_ivnumbercountマークのインプライドボラティリティを持つオプション契約の数。 省略される場合あり
matrix.{*}.{*}.coverage.with_greeksnumbercountグリークスを持つオプション契約の数。 省略される場合あり
datasetsarray—取引所単位ではないデータセット（例：現物ETFやCMEの日次データ）の品質チェック。それぞれにステータス、遅延、カバレッジ、理由が付きます。
datasets[]object—単一の取引所に紐づかない市場全体のデータセット1件（オプション、現物ETF、CME、板、ベーシス）。
datasets[].familystring—データセットID。例：`etf`、`cme`。
datasets[].idstring—識別子。
datasets[].titlestring—データセットの表示名。
datasets[].sourcestring—値の取得元。
datasets[].endpointstring—そのデータセットを提供する公開エンドポイント。
datasets[].statusstring—ステータス。
datasets[].lag_snumbersレスポンスを組み立てた時点における、最新のデータポイントの経過時間。
datasets[].source_atnumbermsタイムスタンプ。
datasets[].fetched_atnumbermsCoinBossがソースからデータを取得した時刻。
datasets[].fresh_within_snumbers鮮度ウィンドウ：これより新しいデータは鮮度内とみなされます。
datasets[].coverageobject—含まれているものと欠けているもの。
datasets[].coverage.funds_totalnumbercount追跡対象のファンド数。 省略される場合あり
datasets[].coverage.funds_coverednumbercount利用可能な開示情報があるファンドの数。 省略される場合あり
datasets[].coverage.funds_unavailablenumbercount発行体が機械可読な開示情報を公表していないファンドの数。 省略される場合あり
datasets[].coverage.funds_failingnumbercount直近の収集ラウンドで開示情報を読み取れなかったファンドの数。 省略される場合あり
datasets[].coverage.as_ofstring—カバー対象のファンドのうち、最も新しい開示日（YYYY-MM-DD）。 省略される場合あり
datasets[].coverage.as_of_minstring—カバー対象のファンドのうち、最も古い開示日（YYYY-MM-DD）。 省略される場合あり
datasets[].reasonstring|null—理由コード。
datasets[].coverage.contractsnumber—契約ごとの行。 省略される場合あり
datasets[].coverage.report_datestring—最新のCFTC建玉明細報告（Commitments of Traders）の日付（YYYY-MM-DD）。 省略される場合あり
datasets[].coverage.productsnumbercountカバー対象のCME商品の数。 省略される場合あり
datasets[].coverage.trade_datestring—最新のCME日次レポートの取引日（YYYY-MM-DD）。 省略される場合あり
summaryobject—概要ブロック。 動的キー: FRESH,PARTIAL,STALE,BROKEN,UNAVAILABLE
summary.{*}number—概要ブロック。
by_familyobject—データ種別ごとの、各ステータスの取引所数。外側のキーはデータ種別IDです。 動的キー: ticker,oi,funding,funding_settle,liquidation,ls
by_family.{*}object—1データ種別のステータス別件数。キーはステータス（`FRESH`、`PARTIAL`、`STALE`、`BROKEN`、`UNAVAILABLE`）です。 動的キー: FRESH,PARTIAL,STALE,BROKEN,UNAVAILABLE
by_family.{*}.{*}numbercountそのデータ種別でそのステータスにある取引所の数。
alertsarray—データ品質巡回のアラートのうち、未解決のもの、または直近7日間に解決されたもの。未解決のものが先頭で、リクエストパラメータで絞り込まれます。
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.patrol_last_run_atnumbermsタイムスタンプ。
monitor.patrol_age_snumbersイベントからの経過秒数。
monitor.patrol_okboolean—巡回が直近15分以内に実行された場合はtrue。falseの場合、`alerts`リストは古くなっている可能性がありますが、マトリックスはライブのままです。
monitor.collector_heartbeat_age_snumbersイベントからの経過秒数。
errorsnull—品質チェック自体が失敗したデータ種別について、データ種別IDからエラーコードへのマップ。すべてのチェックが実行された場合はnull。
legendobject—各セルステータスの定義（平文）。 動的キー: FRESH,PARTIAL,STALE,BROKEN,UNAVAILABLE
legend.{*}string—キーで示されるステータス（`FRESH`、`PARTIAL`、`STALE`、`BROKEN`、`UNAVAILABLE`）の定義。
methodobject—計算式/算出方法の注記。
method.statusstring—ステータス。
method.lag_sstring—`lag_s`の算出方法を平文で記述したもの。
method.source_atstring—日時文字列。
method.fetched_atstring—日時文字列。
metaobject—このレスポンスのエンベロープ：スキーマID、生成元のシステム、タイムスタンプ、キャッシュの有効期間、鮮度。
meta.schemastring—このレスポンスのスキーマID。トップレベルの`schema`と同じ値です。
meta.sourcearray—値の取得元。
meta.source[]object—値の取得元。
meta.source[].systemstring—データを生成したシステム。開発者センターのエンドポイントでは常に`coinboss`です。
meta.source[].componentstring—データの基となるコンポーネント：エンドポイントプローブとデータ品質巡回。
meta.observed_atnull—タイムスタンプ。
meta.received_atnumbermsタイムスタンプ。
meta.fetched_atnumbermsCoinBossがソースからデータを取得した時刻。
meta.windowstring—ウィンドウ。
meta.cache_ttl_snumbersこのレスポンスのサーバー側キャッシュの有効期間。
meta.qualitystring—通常は`FRESH`。品質巡回が15分以内に実行されていない場合は`PARTIAL`（影響を受けるのはアラートリストのみです）。
meta.is_staleboolean—行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。
meta.fallbackstring—入力が鮮度切れまたは欠落している場合に、このエンドポイントが何を返すかに関する注記（平文）。

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

レスポンス例

/api/meta/quality · 実際のレスポンス（2026-11-13 03:53:46 UTCに取得）。 長い配列とマップは表示用に短縮しています：alertsは11件; legendは5件; matrixは30件; summaryは5件; datasetsは12件; familiesは12件。

  • {
    • "success": true,
    • "schema": "coinboss.meta.quality/1",
    • "now": 1794542026126,
    • "families": [
      • { … 7 },
      • { … 7 }
      ],
    • "exchanges": [
      • "aster",
      • "backpack",
      • "binance",
      • "bingx",
      • "bitfinex",
      • "bitget",
      • "bitstamp",
      • "bitunix"
      ],
    • "matrix": {
      • "aster": { … 2 },
      • "backpack": { … 2 }
      },
    • "datasets": [
      • { … 12 },
      • { … 12 }
      ],
    • "summary": {
      • "FRESH": 161,
      • "PARTIAL": 7
      },
    • "by_family": {
      • "ticker": { … 2 },
      • "oi": { … 2 }
      },
    • "alerts": [
      • { … 10 },
      • { … 10 }
      ],
    • "monitor": {
      • "patrol_last_run_at": 1794541745827,
      • "patrol_age_s": 281,
      • "patrol_ok": true,
      • "collector_heartbeat_age_s": 36
      },
    • "errors": null,
    • "legend": {
      • "FRESH": "newest stored data point is inside the fresh window for this family",
      • "PARTIAL": "some contracts / rows are outside the fresh window or miss a required field"
      },
    • "method": {
      • "status": "judged from data timestamps in CoinBoss storage every request (30 s in-process cache); a running collector process is not treated as evidence",
      • "lag_s": "now − newest stored data timestamp for the exchange / family",
      • "source_at": "newest stored data timestamp (exchange timestamp when the exchange provides one, otherwise collector receive time)",
      • "fetched_at": "last successful upstream call recorded by the collector health log; null for WebSocket feeds and collectors that do not log per-call health"
      },
    • "meta": {
      • "schema": "coinboss.meta.quality/1",
      • "source": [ … 1 ],
      • "observed_at": null,
      • "received_at": 1794542026978,
      • "fetched_at": 1794542026126,
      • "window": "latest",
      • "cache_ttl_s": 20,
      • "quality": "FRESH",
      • "is_stale": false,
      • "fallback": "matrix is always computed from storage; when the 5-minute patrol itself stops (monitor.patrol_ok=false) only the alerts list may be outdated"
      }
    }

検証済みサンプル

上の例に加えて、プローブは以下のパラメータでもこのエンドポイントを呼び出し、毎回スキーマを検証しています。

パラメータHTTPレイテンシ結果
exchange=binance2001 ms合格 FRESH
family=funding2001 ms合格 FRESH

2026-11-13 03:29:27 UTCにチェック

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
20s
エッジマイクロキャッシュ
10s
更新頻度
取引所 × データ種別の各組み合わせについて、最新データのタイムスタンプからリクエスト時に評価します。
データソース
CoinBossの生テーブル（最新行のタイムスタンプ）、コレクターのヘルスログ。プロセスが稼働しているだけでは、データが正常とはみなされません。
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版
提供開始
2026-11-11

ライブステータス

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

可用性（過去30日間）

407回のチェック中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/meta/quality利用可能
パラメータ

string — Return only this exchange (lower-case id, for example `binance`).

string — Return only this data family (for example `oi`, `funding`, `liquidation`).

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