GET利用可能FRESH
サービスステータス
全体ステータス、APIインスタンスとストア、失敗中のエンドポイント、レイテンシのパーセンタイル、30日間の可用性、データ種別ごとのコレクター稼働状況、未解決のインシデントを返します。
GET
/api/meta/statusリクエスト
このエンドポイントにパラメータはありません。
リクエスト例
curl -s "https://www.coinboss.com/api/meta/status"レスポンスフィールド
フィールド表は実際のレスポンスから生成しているため、エンドポイントが返す内容をそのまま反映しています。パスでは、配列の要素をa[]、銘柄や取引所などの動的な名前をキーとするオブジェクトを{*}で表します。
| フィールド | 型 | 単位 | 説明 |
|---|---|---|---|
| success | boolean | — | リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。 |
| schema | string | — | このレスポンスのスキーマID(`coinboss.meta.status/1`)。 |
| now | number | ms | レスポンスを生成した時点のサーバー時刻。 |
| overall | string | — | サービス全体のステータス:`operational`、`degraded`、`partial_outage`、`major_outage`、`unknown`のいずれか。`legend`を参照してください。 |
| api_version | string | — | 公開APIのバージョン(`v1`)。 |
| catalog_version | string | — | エンドポイントカタログのバージョン。`2026.11.11`のようなリリース日です。 |
| components | array | — | サービスのコンポーネントとそのステータス:REST API、WebSocketストリーム、データベース、キャッシュ、時系列ストア、エンドポイントプローブ、データ収集。 |
| components[] | object | — | 1コンポーネント分:`id`、`title`、`status`、およびコンポーネントによってフィールドが異なる`detail`オブジェクト。 |
| components[].id | string | — | 識別子。 |
| components[].title | string | — | コンポーネントの表示名。 |
| components[].status | string | — | ステータス。 |
| components[].detail | object | — | 詳細。 |
| components[].detail.instances_healthy | number | count | 直前のヘルスチェックに応答したAPIサーバーインスタンスの数。 省略される場合あり |
| components[].detail.instances_total | number | count | チェックしたAPIサーバーインスタンスの数。 省略される場合あり |
| components[].detail.health_latency_ms | number | ms | APIインスタンスのうち、最も遅いヘルスチェックの応答時間。 省略される場合あり |
| components[].detail.last_check_at | number | ms | タイムスタンプ。 省略される場合あり |
| components[].detail.first_frame_ms | number | ms | 直近のプローブにおいて、WebSocketストリームへの接続から最初のフレームが到着するまでの時間。プローブされていない場合はnull。 省略される場合あり |
| components[].detail.ping_ms | number | ms | コンポーネント(データベース、キャッシュ、または時系列ストア)への単純なクエリの往復時間。APIホストから計測した値です。 省略される場合あり |
| components[].detail.note | null | — | 備考。 省略される場合あり |
| components[].detail.last_run_at | number | ms | タイムスタンプ。 省略される場合あり |
| components[].detail.age_s | number | s | この行が最後に更新されてからの経過秒数。 省略される場合あり |
| components[].detail.interval_s | number | s | プローブ実行の予定間隔(300)。 省略される場合あり |
| components[].detail.took_ms | number | ms | 直近の完了したプローブ実行の所要時間。記録がない場合はnull。 省略される場合あり |
| components[].detail.families_total | number | count | データ収集について評価したデータ種別の数。 省略される場合あり |
| components[].detail.families_degraded | number | count | 収集ステータスが`degraded`または`outage`のデータ種別の数。 省略される場合あり |
| components[].detail.judged_by | string | — | ステータスの判定に使用したタイムスタンプ。 省略される場合あり |
| endpoints | object | — | 各ライブステータスにあるドキュメント化されたエンドポイントの数と、失敗中のエンドポイントのリスト。 |
| endpoints.total | number | — | 合計。 |
| endpoints.available | number | — | データが利用可能かどうか。 |
| endpoints.partial | number | — | 想定されるデータの一部しか存在しない場合はtrue。 |
| endpoints.degraded | number | count | ライブステータスが`degraded`のエンドポイント数。 |
| endpoints.down | number | count | ライブステータスが`down`のエンドポイント数。 |
| endpoints.unavailable | number | — | データが利用できない項目とその理由。0として報告されることはありません。 |
| endpoints.unknown | number | count | ライブステータスが`unknown`(最近のプローブ結果なし)のエンドポイント数。 |
| endpoints.failing | array | — | 現在`down`または`degraded`のエンドポイント。それぞれに`id`、`path`、`status`、`reason`、直近のHTTPステータス、最後の成功時刻、連続失敗回数が付きます。 |
| endpoints.failing[] | object | — | 現在ダウンまたは低下しているエンドポイント1件。 |
| endpoints.failing[].id | string | — | 識別子。 |
| endpoints.failing[].path | string | — | エンドポイントのパス。 |
| endpoints.failing[].status | string | — | ステータス。 |
| endpoints.failing[].reason | string | — | 理由コード。 |
| endpoints.failing[].http | number | — | 直近のプローブのHTTPステータス。一度もプローブされていない場合は`null`。 |
| endpoints.failing[].last_ok_at | number | ms | タイムスタンプ。 |
| endpoints.failing[].fail_streak | number | count | プローブの連続失敗回数。 |
| latency_ms | object | — | 各エンドポイントの直近の成功したプローブ呼び出しの応答時間分布。APIホスト上で計測した値です。 |
| latency_ms.p50 | number | ms | エンドポイント全体の応答時間の中央値。鮮度内のサンプルがない場合はnull。 |
| latency_ms.p95 | number | ms | エンドポイント全体の応答時間の95パーセンタイル。鮮度内のサンプルがない場合はnull。 |
| latency_ms.max | number | — | 最大値。 |
| latency_ms.sample | number | count | レイテンシの数値に含まれるエンドポイントの数。 |
| latency_ms.measured | string | — | レイテンシの計測場所に関する注記(平文):サーバー側で計測し、ネットワーク転送時間は含みません。 |
| uptime | object | — | ウィンドウ内における全エンドポイントのプローブチェック:合計、成功率(パーセント)、日別の内訳。 |
| uptime.window_days | number | days | 稼働率ウィンドウの長さ(30)。 |
| uptime.checks | number | count | ウィンドウ内のプローブチェックの回数(全エンドポイントの合計)。 |
| uptime.ok | number | count | そのうち成功したチェックの回数。 |
| uptime.pct | number | % | パーセント値。 |
| uptime.tracking_since | string | — | ウィンドウ内でプローブデータがある最初の日(`YYYY-MM-DD`)。まだデータがない場合はnull。 |
| uptime.days | array | — | 日次の値、または日数。 |
| uptime.days[] | object | — | 日次の値、または日数。 |
| uptime.days[].day | string | — | 暦日(UTC)。 |
| uptime.days[].checks | number | count | その日のプローブリクエスト数。 |
| uptime.days[].ok | number | count | その日の成功したプローブリクエスト数。 |
| uptime.days[].pct | number | % | パーセント値。 |
| uptime.days[].schema_pct | number | % | その日にプローブしたレスポンスのうち、ドキュメントのフィールド表と一致したものの割合。 |
| uptime.days[].avg_ms | number | ms | その日の平均応答時間。 |
| collectors | object | — | 取引所データ収集の状態。ストレージ内のデータのタイムスタンプから判定します:データ種別ごとの件数、データセットのチェック、巡回のヘルス。評価できない場合はnull。 |
| collectors.families | array | — | データ種別ごとの収集ステータス。 |
| collectors.families[] | object | — | 1データ種別分:`family`、`title`、各状態の取引所数、その結果としての`status`。 |
| collectors.families[].family | string | — | データ種別のID。例:`ticker`、`oi`、`funding`、`liquidation`、`options`。 |
| collectors.families[].title | string | — | データ種別の表示タイトル。 |
| collectors.families[].exchanges_collected | number | count | そのデータ種別を収集している取引所:fresh + partial + stale + broken。 |
| collectors.families[].fresh | number | count | そのデータ種別の最新データが鮮度ウィンドウ内にある取引所。 |
| collectors.families[].partial | number | — | 想定されるデータの一部しか存在しない場合はtrue。 |
| collectors.families[].stale | number | — | 鮮度ウィンドウより古いデータの行、またはそのフラグ。 |
| collectors.families[].broken | number | count | そのデータ種別について、上流が失敗し続けている、または行の大半が妥当性チェックに合格しない取引所。 |
| collectors.families[].unavailable | number | — | データが利用できない項目とその理由。0として報告されることはありません。 |
| collectors.families[].status | string | — | ステータス。 |
| collectors.datasets | array | — | 取引所単位ではないデータセット(例:現物ETFやCMEの日次データ)の品質チェック。それぞれにステータス、遅延、カバレッジ、理由が付きます。 |
| collectors.datasets[] | object | — | 単一の取引所に紐づかない市場全体のデータセット1件(オプション、現物ETF、CME、板、ベーシス)。 |
| collectors.datasets[].family | string | — | データセットID。例:`etf`、`cme`。 |
| collectors.datasets[].id | string | — | 識別子。 |
| collectors.datasets[].title | string | — | データセットの表示名。 |
| collectors.datasets[].source | string | — | 値の取得元。 |
| collectors.datasets[].endpoint | string | — | そのデータセットを提供する公開エンドポイント。 |
| collectors.datasets[].status | string | — | ステータス。 |
| collectors.datasets[].lag_s | number | s | レスポンスを組み立てた時点における、最新のデータポイントの経過時間。 |
| collectors.datasets[].source_at | number | ms | タイムスタンプ。 |
| collectors.datasets[].fetched_at | number | ms | CoinBossがソースからデータを取得した時刻。 |
| collectors.datasets[].fresh_within_s | number | s | 鮮度ウィンドウ:これより新しいデータは鮮度内とみなされます。 |
| collectors.datasets[].coverage | object | — | 含まれているものと欠けているもの。 |
| collectors.datasets[].coverage.funds_total | number | count | 追跡対象のファンド数。 省略される場合あり |
| collectors.datasets[].coverage.funds_covered | number | count | 利用可能な開示情報があるファンドの数。 省略される場合あり |
| collectors.datasets[].coverage.funds_unavailable | number | count | 発行体が機械可読な開示情報を公表していないファンドの数。 省略される場合あり |
| collectors.datasets[].coverage.funds_failing | number | count | 直近の収集ラウンドで開示情報を読み取れなかったファンドの数。 省略される場合あり |
| collectors.datasets[].coverage.as_of | string | — | カバー対象のファンドのうち、最も新しい開示日(YYYY-MM-DD)。 省略される場合あり |
| collectors.datasets[].coverage.as_of_min | string | — | カバー対象のファンドのうち、最も古い開示日(YYYY-MM-DD)。 省略される場合あり |
| collectors.datasets[].reason | string|null | — | 理由コード。 |
| collectors.datasets[].coverage.contracts | number | — | 契約ごとの行。 省略される場合あり |
| collectors.datasets[].coverage.report_date | string | — | 最新のCFTC建玉明細報告(Commitments of Traders)の日付(YYYY-MM-DD)。 省略される場合あり |
| collectors.datasets[].coverage.products | number | count | カバー対象のCME商品の数。 省略される場合あり |
| collectors.datasets[].coverage.trade_date | string | — | 最新のCME日次レポートの取引日(YYYY-MM-DD)。 省略される場合あり |
| collectors.patrol_ok | boolean | — | データ品質巡回が直近15分以内に実行された場合はtrue。 |
| collectors.patrol_age_s | number | s | イベントからの経過秒数。 |
| collectors.evaluated_at | number | ms | タイムスタンプ。 |
| incidents | object | — | 未解決、または直近7日間に解決されたデータ品質アラート:`open`の件数と`items`(最大100件)。 |
| incidents.open | number | — | 期間の始値。 |
| incidents.items | array | — | 結果の項目。 |
| incidents.items[] | object | — | 結果の項目。 |
| incidents.items[].level | string | — | レベル。 |
| incidents.items[].exchange | string | — | 取引所ID(小文字。例:`binance`)。 |
| incidents.items[].family | string | — | アラートの対象となるデータ種別。 |
| incidents.items[].code | string | — | コード。 |
| incidents.items[].detail | string | — | 詳細。 |
| incidents.items[].opened_at | number | ms | タイムスタンプ。 |
| incidents.items[].last_seen_at | number | ms | タイムスタンプ。 |
| incidents.items[].resolved_at | number|null | ms | タイムスタンプ。 |
| incidents.items[].hits | number | count | アラートの発生以降、その状態を検出した巡回の実行回数(5分ごとに1回)。 |
| incidents.items[].open | boolean | — | 期間の始値。 |
| probe | object | — | ライブステータスの基となるエンドポイントプローブの状態:最終実行時刻、その経過時間、間隔、鮮度内かどうか。 |
| probe.last_run_at | number | ms | タイムスタンプ。 |
| probe.age_s | number | s | この行が最後に更新されてからの経過秒数。 |
| probe.interval_s | number | s | プローブ実行の予定間隔(300)。 |
| probe.fresh | boolean | — | 最後のプローブ実行が20分未満前の場合はtrue。falseの場合、エンドポイントのステータスは`unknown`として報告されます。 |
| probe.error | null | — | エラーメッセージ(失敗時のみ存在)。 |
| probe.endpoints_checked | number | count | 直近のプローブラウンドでチェックしたエンドポイントの数。 |
| probe.ok | number | count | 直近のプローブラウンドで正しく応答したエンドポイントの数。 |
| probe.failed | number | count | 直近のプローブラウンドで失敗したエンドポイントの数。 |
| probe.schema_mismatch | number | count | レスポンスがドキュメントのフィールド表と一致しなかったエンドポイントの数。 |
| probe.alt_samples_failed | null | count | 失敗した追加サンプルリクエストの数。直近のラウンドで実行されなかった場合は`null`。 |
| legend | object | — | `overall`の各値の定義(平文)。 |
| legend.operational | string | — | `operational`の定義。 |
| legend.degraded | string | — | `degraded`の定義。 |
| legend.partial_outage | string | — | `partial_outage`の定義。 |
| legend.major_outage | string | — | `major_outage`の定義。 |
| legend.unknown | string | — | `unknown`の定義。 |
| meta | object | — | このレスポンスのエンベロープ:スキーマID、生成元のシステム、タイムスタンプ、キャッシュの有効期間、鮮度。 |
| meta.schema | string | — | このレスポンスのスキーマID。トップレベルの`schema`と同じ値です。 |
| meta.source | array | — | 値の取得元。 |
| meta.source[] | object | — | 値の取得元。 |
| meta.source[].system | string | — | データを生成したシステム。開発者センターのエンドポイントでは常に`coinboss`です。 |
| meta.source[].component | string | — | データの基となるコンポーネント:エンドポイントプローブとデータ品質巡回。 |
| meta.observed_at | null | — | タイムスタンプ。 |
| meta.received_at | number | ms | タイムスタンプ。 |
| meta.fetched_at | number | ms | CoinBossがソースからデータを取得した時刻。 |
| meta.window | string | — | ウィンドウ。 |
| meta.cache_ttl_s | number | s | このレスポンスのサーバー側キャッシュの有効期間。 |
| meta.quality | string | — | エンドポイントプローブが直近20分以内に報告した場合は`FRESH`、それ以外は`STALE`。 |
| meta.is_stale | boolean | — | 行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。 |
| meta.fallback | string | — | 入力が鮮度切れまたは欠落している場合に、このエンドポイントが何を返すかに関する注記(平文)。 |
2026-11-11 23:01 UTCに1件の実レスポンスから生成。
レスポンス例
/api/meta/status · 実際のレスポンス(2026-11-13 03:53:47 UTCに取得)。 長い配列とマップは表示用に短縮しています:componentsは7件; uptime.daysは3件; incidents.itemsは11件; endpoints.failingは25件; collectors.datasetsは12件; collectors.familiesは12件。
- "success"true
- "schema""coinboss.meta.status/1"
- "now"1794542027137
- "overall""partial_outage"
- "api_version""v1"
- "catalog_version""2026.11.12"
- "components"
- "endpoints"
- "total"299
- "available"256
- "partial"17
- "degraded"17
- "down"8
- "unavailable"1
- "unknown"0
- "failing"
- "latency_ms"
- "p50"7
- "p95"839
- "max"10047
- "sample"289
- "measured""server-side, from the probe on the API host (excludes network transit)"
- "uptime"
- "window_days"30
- "checks"119504
- "ok"118277
- "pct"98.97
- "tracking_since""2026-11-11"
- "days"
- "collectors"
- "families"
- "datasets"
- "patrol_ok"true
- "patrol_age_s"282
- "evaluated_at"1794542027976
- "incidents"
- "open"2
- "items"
- "probe"
- "last_run_at"1794541726312
- "age_s"301
- "interval_s"300
- "fresh"true
- "error"null
- "endpoints_checked"290
- "ok"289
- "failed"1
- "schema_mismatch"0
- "alt_samples_failed"null
- "legend"
- "operational""all checks pass"
- "degraded""serving, with stale data, schema drift or reduced redundancy"
- "partial_outage""at least one endpoint or API instance is failing"
- "major_outage""database down, no API instance healthy, or 20%+ of endpoints failing"
- "unknown""the probe has not reported within 20 minutes — status cannot be asserted"
- "meta"
- "schema""coinboss.meta.status/1"
- "source"
- "observed_at"null
- "received_at"1794541726312
- "fetched_at"1794542027137
- "window""latest"
- "cache_ttl_s"15
- "quality""FRESH"
- "is_stale"false
- "fallback""status is \"unknown\" whenever the probe is stale; process liveness is never used as evidence"
詳細
- 認証
- 不要。公開エンドポイントです。
- レート制限
- IPごとに毎分1200リクエスト
- サーバーキャッシュ
- 15s
- エッジマイクロキャッシュ
- 10s
- 更新頻度
- リクエスト時に評価します。エンドポイントの結果は5分ごとのAPIプローブ、コレクターの健全性はデータのタイムスタンプに基づきます。
- データソース
- APIプローブの結果、インスタンスごとのヘルスチェック、データ品質マトリックス、アラートログ。
- タイムスタンプ
- フィールドの説明に別途記載がない限り、Unixエポックミリ秒(UTC)
- レスポンス形式
- json
- 安定性
- 安定版
- 提供開始
- 2026-11-11
ライブステータス
利用可能2026-11-13 03:53:47 UTCにチェックHTTP 200872 msスキーマ一致最新データポイントは5m前
可用性(過去30日間)
407回のチェック中99.75%が合格
エラー
失敗した呼び出しは、すべてのエンドポイントで共通の形式で返されます。一覧はエラーページにあります。 エラーとレート制限 →
| コード | HTTP | 意味 | 対処方法 |
|---|---|---|---|
| INVALID_PARAM | 400 | 必須パラメータが不足しているか、値が受け付けられません。該当するパラメータが特定できる場合は、`param`にその名前が入ります。 | そのまま再試行せず、リクエストを修正してください。 |
| UNAUTHORIZED | 401 | `CB-API-KEY`ヘッダーが送信されましたが、キーが不明か失効済みです。公開データにキーは不要です。ヘッダーを外すか、有効なキーを使用してください。 | そのまま再試行しないでください。 |
| FORBIDDEN | 403 | このルートは公開APIに含まれません(内部用またはアカウント専用)。 | 再試行しないでください。 |
| NOT_FOUND | 404 | 不明なルートであるか、リクエストされた銘柄 / 取引所 / ファンドが存在しません。 | 再試行せず、パスと識別子をカタログと照合してください。 |
| RATE_LIMITED | 429 | リクエスト数が1分あたりの上限を超えました。`Retry-After`に待機すべき秒数が示されます。 | `Retry-After`で示された時間だけ待ってから、バックオフ付きで再試行してください。 |
| INTERNAL | 500 | 予期しないサーバーエラーです。メッセージは意図的に汎用的な内容にしています。報告の際は`request_id`を引用してください。 | 数秒後に1回だけ再試行してください。解消しない場合は、リクエストIDを添えて報告してください。 |
| UPSTREAM_FAILED | 503 | このエンドポイントの背後にあるデータソースが時間内に応答しませんでした。鮮度切れの数値や代替の数値を代わりに返すことはありません。 | バックオフ付きで再試行し、ステータスページを確認してください。 |
| UNAVAILABLE | 501 / 503 | データセットが一時的に準備できていない(キャッシュのウォームアップ中)か、このエンドポイントに適法な公開ソースがまだありません。 | 時間をおいて再試行してください。仕様上利用できないエンドポイントは、カタログに明示されています。 |
| REQUEST_FAILED | 200 | 一部の古いエンドポイントは、HTTP 200で`success: false`を返します。HTTPステータスだけでなく、必ず`success`を確認してください。 | メッセージによって異なります。失敗したリクエストとして扱ってください。 |
試してみる
GET
/api/meta/status利用可能パラメータ
パラメータはありません。
リクエストURL
https://www.coinboss.com/api/meta/statusエンドポイントを選択して「リクエストを送信」を押してください。レスポンス、ヘッダー、所要時間がここに表示されます。
このカテゴリの他のエンドポイント
- データ品質マトリックス(コレクター視点) /api/sd/quality
- APIカタログ /api/meta/catalog
- 変更履歴とバージョニングポリシー /api/meta/changelog
- エンドポイントドキュメント /api/meta/endpoint
- OpenAPIドキュメント /api/meta/openapi
- データ品質マトリックス /api/meta/quality
- サービスステータス /api/meta/status
- 銘柄シンボルがプラットフォームに登録されているかの確認 /api/coin-exists
- 銘柄シンボルとローカルホストのアイコンパスの対応表 /api/coin-icons
- 銘柄ページの集約サマリー /api/content/coin
- サイト全体のセクションサマリー /api/content/summary
- 法定通貨の為替レート表 /api/currency/fx
- 取引所IDとローカルホストのアイコンパスの対応表 /api/exchange-icons
- 死活チェック /api/health
- リサーチページの統計 /api/research/stats