変更履歴

変更履歴とバージョン

APIの変更内容、現在のバージョン、互換性のルールを掲載しています。

v1現在のバージョン
2026.11.12カタログのリビジョン

バージョニングと互換性

バージョニング

  • 公開APIのバージョンはv1です。パスのプレフィックスは`/api`で、バージョン番号は含みません。
  • カタログには、日付ベースの独自のバージョン(`catalog_version`。例:2026.11.11)があります。エンドポイント、パラメータ、ドキュメントのいずれかが変更されるたびに更新されます。
  • 自社データ層エンドポイントの各レスポンスには、`schema` ID(例:`sd.oi.v1`)が含まれます。新しいIDが発行されるのは、既存フィールドの意味または型が変わる場合のみです。

互換性

  • エンドポイント、任意パラメータ、レスポンスフィールド、列挙値、取引所の追加は後方互換の変更であり、随時行われることがあります。クライアントは、未知のフィールドを無視する必要があります。
  • フィールドの削除や名前の変更、型や単位の変更、任意パラメータの必須化は破壊的変更です。リリース前にここで告知します。
  • 修正は例外です。誤った数値の修正、またはこれまで通知なく受け付けられていた無効な入力に対する修正は、即時にリリースされ、公開当日にここに掲載されます。クライアントコードの変更が必要になる可能性がある場合は、破壊的変更として表示されます。
  • カバレッジの拡充(新しい取引所や契約種別の追加)により、数値が変わることがあります。カバレッジは常にレスポンスに含まれるため、合計を比較する前に`coverage`を比較してください。
  • 欠損データは`null`で返され、`coverage.unavailable`に記載されます。0や推定値に置き換えられることはありません。`null`を0として扱うコードは、誤った結果になります。

非推奨化

  • `legacy`と表示されたエンドポイントは引き続き動作しますが、新規の開発では記載されている後継のエンドポイントを使用してください。
  • レガシーエンドポイントの削除は、非推奨化の項目がこの変更履歴に掲載されてから90日以上経過した後に行われます。
  • `beta`と表示されたエンドポイントは、サイトのページ向けのものです。フィールド構成は90日前の告知なしに変更されることがありますが、その場合もすべての変更をここに掲載します。

変更点

追加2026.11.12後方互換

`/api/currency/ex-table`: `market=perpetual`, `delivery` and `all`, plus one status vocabulary

  • New values of `market`: `perpetual` (perpetual contracts), `delivery` (dated futures) and `all` (spot, perpetual and delivery markets of the coin in one list). They return one row per market and number `rank` inside the requested view.
  • Every per-market row carries `market_status` (`ACTIVE`, `EXPIRING`, `EXPIRED`, `NO_QUOTE`, `STALE`), `reason_code` (`NO_QUOTE`, `EXPIRED`, `STALE`, `UNAVAILABLE` or null), `source_at`, `quality`, `is_stale`, `expires_in_s`, `symbol` and `base`. The state is derived from the contract specification of the exchange (expiry) and from the time the ticker was received. `status` and `status_reason` are unchanged.
  • `EXPIRING` marks a contract that still trades and expires within 24 hours (`meta.expiring_window_s`). Rows that are not `ACTIVE` or `EXPIRING` return `price: null`; no price is carried over from an earlier quote or from another contract.
  • `meta` adds `market_status_counts`, `type_counts` and `type_rankable`. The row order is the same for every caller: rankable rows by `volume_usd` descending, then rows without a quote, expired contracts last.
追加2026.11.12後方互換

`/api/liquidation-events` adds event / account counts and BTC high, low and range

  • New fields on every row: `btc_high`, `btc_low`, `btc_range` (USD, high − low) and `btc_range_pct` ((high − low) / low × 100), with `btc_range_meta`. Prices are the median of the UTC daily high / low on Binance (BTC/USDT), Coinbase (BTC/USD) and Kraken (BTC/USD) spot. The fields are null unless all three venues have a final daily candle.
  • New fields on `coinboss` rows: `liquidation_count` (de-duplicated liquidation events; not people) and `account_count` (distinct liquidated accounts on exchanges that expose an account identifier, currently Hyperliquid only; `quality` is `PARTIAL`), each with a `_meta` object giving source, window, quality and coverage. Both are null on baseline rows.
  • CoinBoss does not publish a liquidated-trader (people) count; `coverage.metrics.people_count.quality` is `UNAVAILABLE`. `liquidated_traders` and `btc_amplitude` are unchanged: they stay the text recorded in the third-party source and are not copied into the new fields.
変更2026.11.12後方互換

`/api/currency/ex-table`: per-contract rows carry their own quote and a `status`

  • With `group=pair`, every contract row now uses the ticker of that contract. Before, only the main contract of each exchange had a price and the other rows returned `price: null`.
  • New row fields with `group=pair` and `market=spot`: `status` (`active`, `no_quote`, `not_provided`, `expired`), `status_reason`, `market_type`, `expiry_ts`, `expiry_date`, `native_symbol`, `quote`, `margin_type`, `price_source`, `price_at` and `rank`; the response adds `meta` (freshness window, volume window and unit, sort rule, row counts per status).
  • Rows that are not `active` return `price: null` and are never filled from another contract. `volume_usd` on such rows is `0` only when the exchange reports zero 24h turnover, otherwise `null`.
  • Order with `group=pair`: `active` rows first by `volume_usd` descending (these carry `rank`), then rows without a live quote by `oi_usd` descending, expired contracts last. `contract_type` now follows the exchange contract specification, so dated contracts on Deribit, Bybit, Gate and KuCoin are reported as `delivery`; `expiry` is set for all of them.
  • Requests without `group` return the same rows and fields as before.
変更2026.11.12後方互換

`/api/liquidation-events` returns the Top 10 with a `source` field

  • This corrects the 2026-11-11 entry below. The historical baseline rows (third-party public historical records) are served again, as recorded and without recalculation.
  • Rows recorded by CoinBoss are UTC daily totals from its own collectors. A day is added only when its total is greater than the 10th place of the list at that time. Every row carries `source` (`historical_baseline` or `coinboss`) and `basis`.
  • The list is sorted by `total_usd` and returns 10 rows. New fields: `data[].total_usd` (same value as `amount_usd`), `data[].source`, `data[].basis` and `threshold_usd`. `coverage` is split into `coverage.baseline` and `coverage.coinboss`; the `coverage.source`, `coverage.from` and `coverage.note` fields introduced on 2026-11-11 moved under them.
変更2026.11.12後方互換

上流の障害時はHTTP 503を返し、JSONのエラーボディを維持するようになりました

  • これまでHTTP 502または504を返していた失敗リクエストは、`Retry-After`ヘッダー付きの503を返すようになりました。APIの前段にあるCDNが502と504のレスポンスのボディを独自のテキストに置き換えており、`code`と`request_id`が失われていたためです。503はそのまま通過します。`code`の値は従来と同じです。
  • あるエンドポイントの背後にある上流ソースで障害が起きても、他のエンドポイントには影響しなくなりました。ゲートウェイが別のインスタンスで再試行するのは、接続エラーとタイムアウトの場合に限られます。
  • `/api/sd/options/*`と`/api/sd/cme/overview`は、中国語の漢字で表記した銘柄名を受け付けます。該当する市場がない銘柄には、400ではなく、集計値が`null`のHTTP 200を返します。
  • 資金調達の決済履歴:Bybit、OKX、Gate、Bitgetで取引が特に活発な150銘柄(HTXは40銘柄)について、30日間のウィンドウ内の欠損を検出して埋め直します。これにより、`cum_7d`と`cum_30d`が完全な値になる銘柄が増えます。
修正2026.11.11後方互換

清算変動性指数を修正、ソースを利用できないエンドポイントは503を返すように変更

  • `/api/indicators/cdri`:日単位のグループ化でミリ秒のタイムスタンプを秒として読み取っていたため、日次系列が空になっていました。現在は、完全なUTC日について最大90日分の清算合計を返します。`current.days`(新規フィールド)は使用した日数で、2日分に満たない場合、`current.cdri` / `current.liqCV`は`null`になります。
  • `/api/indicators/reddit-subs`:ソースがリクエストを拒否している間は、HTTP 500ではなく、コード`UNAVAILABLE`のHTTP 503を返します。登録者数は、ソースが正の数を返した場合にのみ保存されます。
  • HTTP 5xxレスポンスのエラーボディは、レガシーの`msg`フィールドに上流のエラーテキストを含めなくなりました。このフィールドには現在、`error`と同じ汎用メッセージが入ります。
修正2026.11.11破壊的変更

更新が止まったレコードにはフラグが付き、合計から除外されます

  • `/api/coins/all`と`/api/coins/search`:48時間を超えて更新されていない銘柄レコードは、`market_cap`と`mcap_rank`を`null`、`is_stale: true`として返し、現行のすべての行の後ろに並びます。適用中のルールは`stale_rule`としてそのまま返されます。
  • `/api/derivatives/coins-full`:1銘柄につき必ず1行になりました。これまでは、複数の銘柄レコードが同じシンボルを共有している場合、レコードごとに1行が返されていました。今後、行には48時間以内に更新された最大のレコードの名称、時価総額、順位が入り、該当するレコードがない場合は`null`になります。`mcap_rank`は新しいフィールドです。
  • `/api/reserves/overview`:すべての行に`updated_at`と`is_stale`が付きます。`total`は36時間以内に更新された取引所のみを合計するようになりました。従来の定義は`total_including_stale`として残し、除外された取引所は`stale_exchanges`に掲載されます。
  • `/api/margin/rates`と`/api/margin-fee/matrix`:金利の更新が止まった資産とセルには`is_stale: true`が付きます。しきい値と件数はトップレベルで返されます。
  • 2026-10-28から2026-11-11までの世界全体の時価総額の日次スナップショットを再計算しました。合計の中に、あり得ない時価総額(ビットコインを上回る値)を持つレコードが2件見つかったためです。コレクターは今後、このような値を`null`として保存します。
変更2026.11.11後方互換

ソースの障害は、失敗させたり最新のように見せたりせず、レスポンス内で報告します

  • `/api/indicators/mempool/pools`:マイニングプールのソースが応答しない場合、HTTP 500ではなく、最後に保存された結果を`stale: true`、`cached_at`、`stale_reason`付きで返します。
  • `/api/etf/funds`:新しい`frozen_fields`オブジェクトを追加しました。2026-10-08にソースが公表を停止したファンド単位のフィールドと、各値が指す日付を示します。
  • `/api/indicators/halving`:新しい`current_difficulty`オブジェクト(`value`、`as_of`、`source`)を追加しました。`difficulty`(難易度調整の進捗)は、そのソースが利用できない間`null`のままです。
  • `/api/browser/detect`:チェーンの照会に失敗した場合に、アクティビティのないアドレスとして報告されることはなくなりました。どのチェーンにも照会できなかった場合、`kind`は`lookup_failed`になります。
  • `/api/currency/flows`:ドキュメントに、エンドポイントが実際に提供する22のウィンドウ(5分〜1年)を掲載しました。
変更2026.11.11破壊的変更

未対応のパラメータ値は、デフォルトデータではなく400を返します

  • `/api/derivatives/kline`:`interval=4h`は、UTCの区切りで1h足から作成した本来の4時間足を返します(以前は1h足を返していました)。`1h`、`4h`、`1d`以外のintervalは400を返します。
  • `/api/options/`配下のオプションエンドポイント:未対応の`currency`は、BTCのデータではなく400を返します。また、7つのエンドポイントすべてで`coin`をエイリアスとして受け付けます。
  • `/api/etf/flows`、`/api/etf/detail`、`/api/etf/funds`、`/api/etf/holdings`:未対応の`asset`は、BTCのデータではなく400を返します。
  • `/api/liquidations/coins`:未対応の`range`は、24hのデータではなく400を返します。適用されたウィンドウは`range`としてそのまま返されます。
  • `limit`は、`/api/liquidations`、`/api/liquidations/largest`、`/api/derivatives/coins-full`で上限1000に切り詰められます。数値でない`limit`は、失敗せずにデフォルト値を使用します。
修正2026.11.11破壊的変更

日次出来高とリサーチ統計を修正しました

  • `/api/volume/coin`:`daily_30d`は、1日分の24hローリングのスナップショットをすべて合算していたため、日次出来高を約24倍に過大計上していました。現在は、UTCの各日の最後のスナップショットを使用します。
  • `topic=derivatives`を指定した`/api/research/stats`:`volume_24h_usd`にも同じ過大計上があり、修正しました。
  • 同じレスポンスの`avg_funding_rate_pct`はパーセント値になり、以前返していた生の小数の約100倍になりました。この値に100を掛けていたコードは修正してください。
修正2026.11.11後方互換

旧マーケットエンドポイントは、更新が止まった行を無視します

  • 対象:`/api/market/tickers`、`/api/market/volume-rank`、`/api/market/open-interest`、`/api/market/funding`、`/api/market/funding-spread`、`/api/market/long-short`、`/api/market/long-short-v2`、`/api/market/overview`、`/api/p3/volume/overview`、`/api/p3/perp-spot-volume`、`/api/volume/btc-ex-share`、`/api/derivatives/coins-full`。
  • 行は最新である間のみ算入されます:ティッカーは1時間以内、建玉は3時間以内(CME:120時間)、資金調達率は4時間以内、ロング/ショート比率は24時間以内。
  • 合計はわずかに小さくなり、一部のリストは短くなります。取引が停止した契約は、最後の値ではなく`null`の価格を示します。
修正2026.11.11後方互換

乗数付き契約をベース銘柄に対応付けました

  • `/api/funding/coin`、`/api/funding/history`、`/api/funding/chart`、`/api/ls/coin`は、銘柄の倍数単位で建値される契約(例:`1000PEPE`)をベース銘柄に対応付けるようになりました。これにより、該当する銘柄ではより多くの取引所が掲載されます。
追加2026.11.11後方互換

6取引所のオプションデータ

  • `/api/sd/options/overview`、`/api/sd/options/expiries`、`/api/sd/options/strikes`、`/api/sd/options/chain`、`/api/sd/options/history`を追加しました。
  • 建玉、24hの想定元本ベースの出来高、プット/コール比率、マックスペイン、ATM IV、25デルタスキュー、IVタームストラクチャーは、Deribit、Binance、Bybit、OKX、Gate、Coincallの契約リストからCoinBossが算出しています。
  • 想定元本ベースの出来高とプレミアム売買代金は別々のフィールドであり、合算されることはありません。取引所が公表していない列は`null`となり、`coverage.field_gaps`に記載されます。
  • 履歴は1時間ごとで、2026-11-11から始まります。それ以前の時間帯はバックフィルされません。
追加2026.11.11後方互換

一次公表資料に基づく現物ETF、CME、CFTCのデータ

  • 発行体の開示情報から構築した`/api/sd/etf/overview`、`/api/sd/etf/funds`、`/api/sd/etf/history`を追加しました。合計はCoinBossが収集できるファンドを対象とし、それ以外のファンドはすべて理由付きで掲載されます。`totals_scope`は常に`covered_funds_only`です。
  • ファンドのフローは、発行済口数とNAV(または純資産とNAV)からCoinBossが算出しています。使用した計算式は、ファンドごとに`flow_method`で返されます。
  • `/api/sd/cme/overview`(CMEの8商品の日次出来高と建玉)と`/api/sd/cme/cot`(トレーダー区分別の週次CFTCポジション動向)を追加しました。
  • CMEの決済価格はまだ収集していません。USD建ての数値にはラベル付きの参照価格(`price_src`)を使用しており、そのため概要はPARTIALと判定されます。
追加2026.11.11後方互換

板の厚みとスリッページ

  • `/api/sd/liquidity`、`/api/sd/liquidity/history`、`/api/sd/liquidity/rank`を追加しました。
  • 仲値の±0.5 %、±1 %、±2 %以内の板の厚みと、10k / 100k / 1M USDの成行注文に対するスリッページを、24取引所の実際の板スナップショットから、無期限先物市場と現物市場に分けて算出しています。
  • 価格帯に届かないスナップショットには`complete: false`のフラグが付き、下限値として報告され、集計値から除外されます。`n_included`は、合計に含まれる板の数を示します。
  • `/api/indicators/large-orderbook`はモデルの出力であり、板情報ではありません。板に並んでいる流動性については、新しいエンドポイントを使用してください。
追加2026.11.11後方互換

取引所のマーク価格とインデックス価格に基づくベーシス

  • `/api/sd/basis`、`/api/sd/basis/history`、`/api/sd/basis/rank`を追加しました。
  • 無期限先物のベーシス = 同一取引所における(mark − index) ÷ index × 100。現物対無期限先物のベーシスは、無期限先物を同じ取引所の現物市場と比較します。限月先物には年率換算値が加わります。
  • 集計値は、OI加重、出来高加重、中央値の3種類で提供します。算入ルールを満たさない行も、`excluded_reason`付きで返されます。
  • 1時間ごとの履歴は2026-11-11から始まります。
変更2026.11.11後方互換

アイコンマップは公開サイトのオリジンを使用します

  • `/api/coin-icons`と`/api/exchange-icons`は、他のすべての公開エンドポイントと同じオリジンである`https://www.coinboss.com`上のアイコンURLを返します。パス(`/api/coin-icon/{coin}`、`/api/exchange-icon/{exchange}`)は変更ありません。
非推奨2026.11.11後方互換

`/api/basis/list`と`/api/cftc/cot`をレガシーに指定

  • `/api/basis/list`の代わりに`/api/sd/basis/rank`を、`/api/cftc/cot`の代わりに`/api/sd/cme/cot`を使用してください。レガシーエンドポイントは引き続き動作します。
変更2026.11.11後方互換

`/api/liquidation-events`はCoinBossのレコードのみを返すように変更

  • このリストは、CoinBossが取引所のフィードから受信した清算注文で構成されます。履歴は2026-08-19から始まり、それ以前の日付では行は返されません。
  • フィールドの名前と型に変更はありません。
削除2026.11.11後方互換

運用系エンドポイントはインターネットからアクセスできなくなりました

  • `/api/health/alerts`、`/api/health/server`、`/api/health/history`、`/api/health/ch-read`は、外部からのリクエストに404を返します。これらはもともと公開APIには含まれていません。
  • サービスステータスには`/api/meta/status`を、データの鮮度には`/api/meta/quality`を使用してください。
追加2026.11.11後方互換

デベロッパーセンターと機械可読なAPIメタデータ

  • `/api/meta/catalog`、`/api/meta/endpoint`、`/api/meta/status`、`/api/meta/quality`、`/api/meta/changelog`、`/api/meta/openapi`を追加しました。
  • ドキュメントのフィールド表とレスポンス例は、すべての公開エンドポイントを5分ごとに呼び出すAPIプローブが、実際のレスポンスから生成しています。
  • エンドポイントのステータス(available / partial / degraded / down / unavailable)は、プロセスの状態ではなく、これらの実呼び出しに基づくようになりました。
変更2026.11.11後方互換

エラーボディの統一とリクエストID

  • すべてのレスポンスに`X-Request-Id`ヘッダーが付与されます。エラーボディには、同じ値が`request_id`として含まれます。
  • エラーボディは、すべてのエンドポイントで`{ success: false, code, error, request_id }`になりました。`error`は文字列のままなので、既存のクライアントは引き続き動作します。
  • 不明な`/api/*`ルートは、HTMLページではなくJSONの404(`NOT_FOUND`)を返します。
  • HTTP 429のレスポンスには`Retry-After`が含まれます。
  • 5xxエラーのメッセージは汎用的な内容になり、内部の詳細は返されなくなりました。
追加2026.11.11後方互換

すべてのレスポンスにカバレッジと品質を含む自社データ層エンドポイント

  • `/api/sd/oi`、`/api/sd/funding`、`/api/sd/liquidations`、`/api/sd/volume`、`/api/sd/ls`、`/api/sd/coin`、`/api/sd/quality`を追加しました。
  • 建玉は、USDT建て / USDC建て / コイン証拠金型 / 限月先物の契約を分けて報告し、両側の数値を報告する取引所を明示します。
  • 資金調達率は、生の値とその間隔に加え、8hに正規化した値と年率換算値を返します。契約が稼働していない取引所は除外され、その旨が記載されます。
非推奨2026.11.11後方互換

`/api/market/long-short`をレガシーに指定

  • リスト表示には`/api/market/long-short-v2`を、取引所別のアカウント / ポジション / テイカー比率には`/api/sd/ls`を使用してください。
変更2026.10.31後方互換

アイコンフィールドは同一オリジンのパスを返すように変更

  • `image_url` / `icon`などのフィールドには、第三者のURLではなくCoinBossのパス(`/api/coin-icon/...`)が入るようになりました。
  • 検証済みのアイコンがない銘柄は`null`を返します。クライアント側で独自のプレースホルダーを表示してください。
修正2026.10.24後方互換

鮮度切れの行は集計値に算入されなくなりました

  • 建玉、資金調達率、ロング/ショートの合計には、鮮度ウィンドウ内に更新された行のみを使用します(日次で公表するCMEには、より長いウィンドウを適用)。
  • 上場廃止となった契約は、最終更新がウィンドウから外れた時点で合計に算入されなくなります。

レガシーエンドポイント

互換性のために維持しています。引き続き動作しますが、新規の連携では後継のエンドポイントを使用してください。

エンドポイント後継説明
/api/market/long-short/api/market/long-short-v2既存の連携のために維持しています。`/api/market/long-short-v2`(取引所フィルターを追加)または`/api/sd/ls`(取引所別。アカウント/ポジション/テイカーを別々に保持)を使用してください。
/api/basis/list/api/sd/basis/rank`apr_pct`は`basis_pct × 3 × 365`であり、現在の無期限先物ベーシスが8時間ごとに支払われると仮定して単純に外挿した値です。資金調達率や限月先物の利回りではありません。`/api/sd/basis`は、マーク価格対インデックス価格、現物対無期限先物、限月先物のベーシスを個別に返します。