bitcoin-risk-brief

Bitcoin Risk Brief

Bitcoin Risk Brief は、正規の日次 BTC/USD データを透明性の高いリスクスコア、データ鮮度の状態、シナリオ別価格ラダーに変換する、無料のオープンソース製品です。永久に無料で利用できます。有料プラン、アカウント、SLA はありません。独自のソースコード、ドキュメント、設定は Apache-2.0 ライセンスですが、同梱されているサードパーティの BTC/USD 市場データは対象外です。

2026-08-09 に取得した最初のビューポートです。表示されている値は、ある時点の一例です。

製品のライブサイト：bitcoinriskbrief.minihub.app

現在の値を利用する前に、利用準備状況を確認してください。

curl --fail --silent --show-error https://bitcoinriskbrief.minihub.app/api/readiness

2026-08-09 に取得したレスポンス：

{
  "status": "ready",
  "checks": {
    "risk_data_available": true,
    "validation_available": true,
    "risk_range_ok": true,
    "validation_has_rows": true,
    "latest_matches_validation_end": true,
    "source_is_canonical": true,
    "data_fresh": true
  },
  "data": {
    "latest_date": "2026-08-08",
    "covered_end": "2026-08-08",
    "data_age_days": 1,
    "max_age_days": 2,
    "source": "coinmarketcap_csv",
    "row_count": 5871,
    "methodology_version": "crypto-scout-canonical-v1.1"
  }
}

機能

• 正規の日次履歴 collector/btc-csv/btc_usd_daily.csv から、日次の 0.0～1.0 の Bitcoin リスク指標を算出します。
• 最新の low、neutral、high の状態を、2 年間のリスク履歴チャートとともに表示します。
• 完了したローソク足の HLC3 モデル価格コンテキストと、0.025 刻みのリスクレベル別シナリオラダーを表示します。
• 英語、ロシア語、簡体字中国語、ドイツ語、フランス語、スペイン語、アラビア語で日次ブリーフを公開します。
• 読み取り専用の分析エンドポイントを提供し、メールによるウェイトリスト登録をサーバー側で受け付けます。ブラウザーのストレージには保存しません。ユーザーは機密情報を送信しないでください。

特徴

• データ鮮度と利用準備状況を可視化。 UI には最新の完了日と検証状態が表示されます。鮮度または検証チェックに失敗すると、/api/readiness は HTTP 503 を返します。
• 決定論的で再現可能。 バージョン管理された方法論により、同一の正規日次履歴から指標を再計算します。検証メタデータには各インポートの記録が残ります。
• 予測ではなくシナリオ。 価格ラダーでは仮定の価格を同じモデルに適用し、リスクレベルが変化する価格帯を示します。これは予測でも、取引の指示でもありません。

現在の状況

現在の運用状況、根拠、受け入れている制限については、本番環境への準備状況を参照してください。

AI エージェント向け

まず、リポジトリの llms.txt を確認してください。このブランチでは、機械可読な /api/openapi.json エンドポイントが定義されています。デプロイは現在、運用担当者による作業待ちです。エンドポイントの例、キャッシュのセマンティクス、解釈の境界については、エージェントアクセスパックを参照してください。

エージェントは最初に /api/readiness を呼び出し、報告された値をその日付とデータ鮮度の状態に結び付け、分析であり助言ではないという位置付けを維持する必要があります。

アーキテクチャ

サービス	技術スタック	目的
timescaledb	TimescaleDB/PostgreSQL	BTC OHLCV、リスク行、検証状態、ブリーフのスナップショット、ウェイトリスト登録情報
data-collector	Python、asyncpg、APScheduler、httpx	日次 CSV の更新、CSV 全件インポート、リスクの再計算
backend	FastAPI、asyncpg	API、利用準備状況、ウェイトリスト情報の保存、リスクとブリーフの読み取り
frontend	React、Vite、ECharts、nginx	7 言語対応の公開インターフェースと API プロキシ

flowchart LR
    Source[CoinMarketCap public download<br/>or optional API] --> CSV[Canonical BTC daily CSV]
    Schedule[Daily collector schedule] --> Collector[data-collector]
    CSV --> Collector
    Collector --> DB[(TimescaleDB)]
    DB --> API[FastAPI backend]
    API --> UI[React frontend]
    API --> Agents[AI agents and API clients]

正規 CSV は永続的な信頼できる情報源です。コレクターがこれを更新・検証し、リスクを再計算して、API が利用する日次スナップショットを書き込みます。

クイックスタート

cp .env.example .env
./scripts/manage.sh validate
./scripts/manage.sh start
./scripts/manage.sh migrate
./scripts/manage.sh backfill

開く URL：http://localhost:3001

ドキュメント

• ドキュメントの目次
• 製品概要
• リスク評価の方法論
• アーキテクチャ
• API リファレンス
• 鮮度と検証
• エージェントのドキュメント
• 運用と本番環境のエビデンス

免責事項とライセンス

Bitcoin Risk Brief は、分析と調査のコンテキストのみを提供します。金融上の助言、投資助言、価格予測、または取引の推奨ではありません。

独自のソースコード、ドキュメント、設定は Apache-2.0 の下でライセンスされています。同梱されているサードパーティの BTC/USD 市場データには、引き続きデータ提供元の利用規約が適用されます。NOTICE をご覧ください。