DATA API · v1 · BETA

FXIR Data API

検証済みバッチデータのAPI。リアルタイム介入検知ではない（検知系は将来、取引系と物理分離した別系統で提供する）。全エンドポイントはサイトで無料公開中の同一ファイルを配信し、APIだけの先行データは存在しない（Canonical Event First・会則第39条）。売り物はデータではなく、鍵つき安定エンドポイント・版付きパス・履歴整備という配送である。

βプログラム（無料・受付中）

info@fxir.jp へ「API β希望」と送れば鍵を発行する（beta: 500リクエスト/日・個人/評価用・best effort）。有料プラン（pro: 5,000/日・商用利用可・安定配送・履歴・サポート）は法務確認の完了後に開始し、βキーには移行案内を送る。課金差は配送であってデータ内容ではない——「Proだけ真実を多く知れる」設計はしない。

認証と改ざん検証

認証は X-FXIR-KEY ヘッダのみを正とする（?key=はβ限定の非推奨互換。応答にDeprecationヘッダが付き、正式版で廃止）。鍵はfxir_<plan>_…形式・平文表示は発行時1回のみ・サーバはSHA-256ハッシュだけを保持し、失効（revoke）できる。

curl -H "X-FXIR-KEY: あなたの鍵" https://fxir.jp/api/v1/events

Verifiable Envelope（v1.1）

JSON応答は全て meta＋data の封筒で返る。meta.sha256はcanonical原本のハッシュ——値だけ抜いて証拠状態を落とす事故を防ぎ、レスポンス→canonical→（公開後は）Git commit→計算コード→原資料まで利用者自身が辿れる。

{"meta": {"schema": "fxir.events.v1", "generated_at": "…",
          "source_commit": "…", "sha256": "…",
          "canonical_url": "https://fxir.jp/data/events.json"},
 "data": { …canonicalと同一… }}
# 検証: curl -s <canonical_url> | sha256sum  →  meta.sha256 と一致

エンドポイント（GET・v1固定）

パス	内容	形式
/api/v1/ping	疎通・一覧（認証不要）	JSON
/api/v1/episodes ・ /episodes/full	介入エピソード（要約／証拠状態つき完全版）	JSON
/api/v1/events	イベント台帳（E6・レートチェックRC-1〜4）	JSON
/api/v1/ratecheck	Rate Check Monitor（N-003準拠）	JSON
/api/v1/calendar	検証カレンダー — resolution（当研究所の主張の決着日）とrelease（日銀主な意見・企業物価指数などの定期観測日。Detector抑制窓・交絡注記用であり予測には用いない）の二層	JSON
/api/v1/cftc/latest ・ /history	CFTC円建玉（最新・週次系列）	JSON / CSV
/api/v1/h41/latest ・ /history	FRB H.4.1 海外勘定（最新・週次系列）	JSON / CSV
/api/v1/research/{id}/claims	構造化claims — どの主張がFACTでどれがHYPOTHESISか（WP-001／N-003）	JSON
/api/v1/registry ・ /corrections ・ /status	研究台帳・訂正記録・稼働状態	JSON

応答規約

エラーは全てJSON。破壊的変更はしない——必要になれば/v2を新設し、v1は最低12ヶ月併存する。時刻表現（pingのtime・X-RateLimit-Resetのepoch）はUTC（METHOD §一の明示的例外・SPEC v1.1.2 §六の二）。

code	意味
401	鍵の欠落・不正（`WWW-Authenticate: FXIR-KEY` 付き）
403	鍵は既知だが失効（revoked）
404 / 405	未定義パス／ GET以外
429	レート上限（Retry-After・X-RateLimit-Reset付、UTC 00:00リセット）
503	鍵を提示されたが台帳未設置（運用者側の一時状態のみ）

更新スケジュール（ベストエフォート・SLA明文化は有料開始時）

CFTC: 公表（金曜15:30 ET）後、通常土曜午前JSTまでに反映／ H.4.1: 公表（木曜16:30 ET）後、通常金曜午前JSTまでに反映／ episodes・events・calendar: 研究更新に随時追従。

仕様正本: SPEC-API v1.1.2（単体完結。v1.1.1／v1.1／v1.0保存）｜レート制限はUTC 00:00リセット・全応答にX-RateLimit-Reset。履歴の無料/Pro境界: 現在canonicalと再現用公開履歴は無料、Proは過去状態を便利に取り出す配送（snapshots・as-of・一括）に課金する｜本APIの利用は投資助言の提供を意味しない（会則第42条）。