変更履歴
Data API とそのコントラクトに対するすべての変更を新しい順に掲載しています。バージョン番号はバージョニングと非推奨化のポリシーに従います。
Smithery のように Authorization を独自のサインイン専用に使うクライアントやゲートウェイ向けに、/mcp は MCP キーを X-API-Key: YOUR_API_KEY ヘッダーとしても受け付けるようになりました。Authorization: Bearer は引き続き機能し、ドキュメントで案内するデフォルトの方式のままです。両方のヘッダーが送信された場合、検証されるのは X-API-Key のキーです。/api/v1 の Data API が受け付けるのは、これまでどおり Bearer キーのみです。認証失敗に対するレート制限が IP ごとに加えてキーごとにも適用されるようになったため、あるクライアントの無効なキーが原因で、同じ IP を共有する他のクライアントまでロックアウトされることはなくなりました。
GET /calculators/compound-interest は期間を複利期間の整数倍に丸めていたため、複利期間の途中で終わる期間は長すぎたり短すぎたりする形でシミュレーションされていました。annually 複利で 6 か月の場合は丸 1 年分（入金 12 回と 1 年分の利息）が計算され、5 か月の場合は 1 期間も計算されませんでした（入金も利息もなし）。現在は整数分の期間をこれまでどおり計算し、最後の端数期間には按分で利息を付け（端数分は単利）、期間内のすべての入金を計上します。期間が複利期間の整数倍の場合、結果は変わりません。パラメーターとレスポンスのフィールドに変更はありません。
API とそのドキュメントは rate を複利期間あたりの金利として扱っていましたが、ウェブサイトの計算機とその使い方ガイドは年利を使用していました。GET /calculators/compound-interest は rate を各複利期間にそのまま適用していたため、年 5% を毎月複利にすると毎月 5% で増えていました。現在の rate は年間の名目金利で、各期間には rate を 1 年あたりの期間数で割った金利が適用されます（年 5% を毎月複利にすると毎月 5/12%）。この旨は meta.note にも記載されています。パラメーターとレスポンスのフィールドに変更はありません。annually 以外のすべての複利頻度で結果が変わります。また、contribution_frequency と compound_frequency がどちらも daily、またはどちらも weekly の場合は、浮動小数点の丸め誤差で入金が遅れたり抜け落ちたりしなくなったため、duration_unit=months では total_contributions が入金 1 回分多くなる場合があります。既存のパラメーターの意味が変わります。以前の結果を再現するには、rate に 1 年あたりの複利期間数を掛けてください。
すべての Fear & Greed 値に、score と並んで index が含まれるようになりました。これは Bitculator の表示とまったく同じ 0〜100 の Fear & Greed 指数です（0〜19 極度の恐怖、20〜39 恐怖、40〜59 中立、60〜79 強欲、80〜100 極度の強欲）。表示にはこちらを使ってください。score は変更なしで、index の元になる −100〜+100 の生の合成値です。対象は GET /sentiment/fear-greed（メインの値と intervals の各エントリ）、GET /global の fear_greed、GET /global/heatmap の meta.fear_greed です。追加のみで、既存フィールドは変更されていません。
GET /coins/{slug} は、最大供給量のないコイン（上限のない Solana や Ethereum など）で fully_diluted_valuation を 0 として返していました。現在は総供給量で代替し、どちらも不明な場合は null を返します。これは OpenAPI コントラクトで既に記載されていた仕様です。
循環供給量のないコインでは marketcap と dominance が null になることがあり、ランク外の取引所では信頼スコアの score と breakdown が null になります。選択したメトリクスの現在値がコインにない場合、POST /alarms は 422 を返します。/coins/recently-added と /wallets/timeline が sort に従うようになりました。/coins/gainers と /coins/losers は変動率そのもので並べ替えられ（以前は実質的に時価総額順）、losers からは 0.00 のコインが除外されます。昇順の並べ替えでは null 値が最後になります。/prices は、曖昧なシンボルを最上位ランクのアクティブなコインに解決します。OpenAPI コントラクトは null になりうるマーケット項目を示し、24 時間出来高を数値型として定義します。
公開しているコントラクトに、メディアタイプレベルの例、すべての 4xx/5xx レスポンスから参照される共通エラースキーマ、キー付き呼び出しが返しうる 401・429・500 レスポンス、すべての成功レスポンスに付く X-RateLimit-* と X-Quota-* ヘッダー、POST /webhooks のコールバックとしての alarm.triggered 配信、そして連絡先・ライセンス・利用規約のメタデータが加わりました。リクエストやレスポンス自体は変わっていません - 変わったのは記述方法だけです。
新規: /apis.json、/.well-known/api-catalog（RFC 9727）、/.well-known/security.txt（RFC 9116）、共通レスポンス形状の JSON Schema バンドル、JSON 版を備えた公開ステータスページ、この変更履歴、そしてバージョニングと非推奨化のポリシー。
MCP サーバーは、MCP コンソールで発行する専用のキーとプランに移行しました。/mcp では Data API キーを受け付けなくなりました。ツール呼び出し 1 回のコストは引き続きリクエスト 1 回分です。
Bitculator MCP サーバーが /mcp で稼働開始: Claude、Cursor、VS Code、あらゆる MCP クライアント向けに、Streamable HTTP 経由の読み取り専用ツール 19 個を提供し、REST API と同じ 10 進文字列データを返します。
TypeScript、Python、PHP、Go、Rust、Java、C#、C++ のクライアント。いずれも同じトランスポートコアの上ですべてのエンドポイントをカバーします: Bearer 認証、エンベロープの展開、X-Quota-* の取得、429 と 5xx でのリトライ、型付きエラー、ページング。
一部のエンドポイントと長期のインジケーターウィンドウには Starter または Pro が必要になりました。プラン外の呼び出しは 403 plan_required を返し、details.required_plan にアンロックに必要なプランが示されます。クォータは消費しません。
ローンチ: 15 グループにわたる 85 オペレーション - コイン、価格、マーケット、取引所、ウォレット、グローバル、センチメント、インジケーター、清算、換算、計算ツール、編集コンテンツ、アラーム、Webhook、メタ。data-api 権限付きの Bearer キー、{ data, meta } エンベロープ、10 進文字列の精度、X-Quota-* ヘッダー、署名付き Webhook、そしてそれぞれ月間クォータを持つ Free・Starter・Pro プラン。
非推奨化は、削除の少なくとも 6 か月前に、このページとすべてのキー所有者へのメールで告知します - 非推奨化ポリシーをご覧ください。機械可読インデックス /apis.json は、最新エントリーの日付を modified スタンプとして保持します。