プロダクト

Kurage FX AI Trade（kfxai）

Kurage FX AI Trade（kfxai）は、OANDA APIを利用したFX自動売買OSSで、差し替え可能なAI判断レイヤーを持つ。

Kurage FX AI Trade（kfxai）は、kurage（AI VTuber）が運用するFX自動売買システムです。oandaの価格・注文APIを使うOSS本体と、差し替え可能なAI判断レイヤーを分離した構成で、初期設定はpaper（ペーパートレード）のため実口座へ注文しません。kfreqai（暗号資産版）の姉妹プロジェクトに当たります。

特徴

データで仮説を棄却する姿勢 — 機械学習による方向予測（ロジスティック回帰・LightGBM、M15/H1/H4の3時間軸、約1万取引のwalk-forward検証）を実施し、方向的中率49〜52%（損益分岐点は52.6%）で全構成が赤字だったため、MLでの方向予測を廃棄しました。
生き残った戦略だけを運用 — 1.6年・570取引の検証を全パラメータで黒字通過した「東京レンジ→ロンドンブレイクアウト」（円ペア限定）のみを採用。USD/JPY・EUR/JPY・GBP/JPYに優位性が集中するという構造的な理由づけがあります。
円ペア限定の根拠 — AUD/JPYは検証窓で赤字、EUR/USDはパラメータで符号が反転したため除外。「都合のいい銘柄選びではなく、構造で絞った」と明言しています。
OSS本体 — GPL-3.0で公開。OANDA接続、方向予測、注文、損切り・利確、スプレッド制限、日次損失制限、SQLite履歴、ダッシュボードを備え、予測・リスク制御・paper取引・取引後レビュー・改善仮説の検証を継続します。

モード

モード	価格	注文
`paper`	OANDA Practice	SQLite内の仮想取引
`practice`	OANDA Practice	OANDA Practice口座
`live`	OANDA Live	実口座。環境と明示的な確認文字列が必須

liveはOANDA_ENVIRONMENT=liveとKFXAI_LIVE_ACK=I_UNDERSTAND_THIS_USES_REAL_MONEYが同時に設定されない限り起動しません。

信頼境界

kfxaiの判断レイヤー（地合い分類・リスク指示・取引レビュー・改善仮説）は差し替え式で、KFXAI_JUDGMENT_BACKENDで選択します。

rule_based: 外部LLMなしの完全ローカル基準実装
local_llm: local-llmで判断し、障害時はルールへ安全にフォールバック
x402: kfxbrainなどの有料判断API（KFXAI_BRAIN_URL）を利用

どの頭脳を選んでも、頭脳は注文API・認証情報・注文数量を持ちません。最終的なリスク判定は自分で動かすボディ側（OSS本体）だけが行います。これはtrust-boundaryの典型的な実装です。知能APIを自前で提供する場合はKFXAI_BRAIN_ENGINE=local_llm kfxai-brainで127.0.0.1:18325に起動します。

バイブトレーディングとの関係

kfxaiはvibe-tradingをFXで実践した記録です。「仮説は人間、コードはAI、判定は数字」という分業に従い、AIの提案を鵜呑みにせず数字で検証します。実践ツール一式の総まとめは「バイブトレーディング実践ガイド」にあります。

利用形態

初期設定はpaper（OANDA Practiceの実勢価格に対する仮想取引）。practice（OANDA Practice口座）やlive（実口座）への切替は明示的な環境設定と確認文字列が必要
常駐運用はsystemd: kfxai-api.service（状態API・ダッシュボード）、kfxai-worker.service（5分間隔の取引サイクル）、kfxai-brain.service（判断API）、kfxai-research.timer（8時間ごとの改善仮説検証）
公開用PHPはpublic/kfxai.php。https://kurage.exbridge.jp/kfxai.phpで状態表示
Docker（docker compose up --build）でも起動可能。APIとbrainはlocalhostのみに公開
有料の頭脳としてkfxbrainを利用可能（x402による従量課金）
テストはOANDAへ接続せず、疑似市場データと疑似API応答で価格解析・注文payload・リスクゲート・APIを確認（ruff check / pytest -q）

技術スタック

Python 3.10+ / FastAPI / OANDA v20 REST / SQLite / Gemma 4 12B（Ollama） / systemd / Docker / GPL-3.0-only

注意事項

本ソフトウェアは投資助言ではありません。
FXはレバレッジにより元本を超える損失が発生する可能性があります。
OANDA Japan株式会社またはOANDAグループによる承認・提携を示すものではありません。
API仕様と取引条件は必ずOANDA公式資料と契約口座で確認してください。
Practiceで十分な期間検証し、スリッページ、通信障害、金利調整、税務を含めて評価してください。