Kurage FX AI Trade(kfxai)
OANDAを利用し、OSS取引ボディとAI判断レイヤーを分離したKurageシリーズのFX自動売買システム
概要
Kurage FX AI Trade(kfxai)は、kurage(AI VTuber)が運用するFX自動売買システムです。LPでは「測ってから取引するFXペーパートレード」と銘打ち、paper-tradingを実践します。初期状態はpaperモードで、OANDA Practiceの実勢価格に対する仮想取引のみを行い、実口座へは注文しません。oandaの価格・注文APIを利用するOSS本体(GPL-3.0-only)と、差し替え可能なAI判断レイヤーを分離した構成で、予測、リスク制御、paper取引、取引後レビュー、改善仮説の検証を継続します。kfreqai(暗号資産版)の姉妹プロジェクトに当たり、検証で棄却した仮説も含めて全過程を公開しています。
公開URL
- プロダクトLP: https://kfxai.exbridge.jp/ / https://kfxai.exbridge.jp/kfxai.html
- 状態ダッシュボード: https://kurage.exbridge.jp/kfxai.php
exbridgeが公開するkurage-platform上のプロダクトの一つです。ダッシュボードの公開面はpublic/kfxai.phpがWebサーバから読み取り専用APIへ接続して状態を表示します。
アーキテクチャ
OANDA candles/pricing
|
v
local direction model ---> rule / Ollama / x402 judgment brain
| |
+---------- fixed risk gates
|
paper / OANDA Practice / live
|
journal and research loop
- OSS body: OANDA接続、方向予測、注文、損切り・利確、スプレッド制限、日次損失制限、SQLite履歴、ダッシュボードを担当
- Metered brain: 地合い分類、リスク指示、取引反省、改善仮説を提供。x402対応ゲートウェイの背後に配置可能
信頼境界
kfxaiの判断レイヤーはKFXAI_JUDGMENT_BACKENDで選択します。
rule_based: 外部LLMなしの完全ローカル基準実装local_llm: local-llm(Ollama)で判断し、障害時はルールへ安全にフォールバックx402: x402対応の有料判断API(KFXAI_BRAIN_URL)を利用
どの頭脳を選んでも、AI判断レイヤーは注文API、認証情報、注文数量を持ちません。最終的なリスク判定は自分で動かすOSS本体だけが行います。これはtrust-boundaryの典型的な実装です。OSS本体側には固定リスクゲート(スプレッド上限、日次損失上限、最大ポジション数、全注文への損切り・利確設定、SQLite取引ジャーナル)が組み込まれており、cloneすればLLMなしでもルールベースの頭脳でペーパートレードがそのまま動きます。判断APIを自前で提供する場合はKFXAI_BRAIN_ENGINE=local_llm kfxai-brainで起動します。
データが語ったこと:ML方向予測の棄却
- ロジスティック回帰・LightGBM、M15/H1/H4の3時間軸、トリプルバリアラベル・特徴量追加を含む7構成・約1万取引をwalk-forward検証。
- 方向的中率は49〜52%(損益分岐点は52.6%)で、全構成が赤字。H4足・2.5年・2,922取引の検証でも49.2%とコイントス並みでした。
- 「モデルが自信のあるときだけ取引する」フィルタを掛けても全窓で赤字。
- 「本物に見えたエッジ」も時間軸で偽物と判明しました。AUD/JPYはH1で+7,277(ペーパー円)の利益に見えましたが、H4では-26,697に反転。窓や時間軸で符号が変わるのは、モデルのブレがシグナルのふりをしている典型と判断して除外しています。
- 検証スクリプト(
scripts/backtest.py)もリポジトリで公開しており、捨てた仮説や失敗の記録こそ次の仮説を生む材料になるとの立場で、棄却の過程も公開しています。
このためkfxaiは機械学習の方向予測では取引しません。
生き残った戦略:東京レンジ→ロンドンブレイクアウト
- 東京時間(00-07 UTC)のレンジを、ロンドン時間(07-12 UTC)にブレイクした方向へ順張り。
- 損切りはレンジの反対側、利確はレンジ幅の1.5倍、21:00 UTCに強制手仕舞い、1銘柄1日1取引。
- 1.6年・570取引の検証で、試した全パラメータ(利確倍率・バッファ)で黒字。
- 2つの独立した検証窓、利確倍率スイープ(+770〜+8,841ペーパー円・1,000通貨)も単調増加。バッファスイープも全て黒字でした。
- 円ペア(USD/JPY・EUR/JPY・GBP/JPY)限定。AUD/JPYは両検証窓で赤字、EUR/USDはパラメータで符号が反転するため除外。「都合のいい銘柄選びではなく、構造で絞った」と明言しています。
取引モード
| モード | 価格 | 注文 |
|---|---|---|
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が同時に設定されない限り起動しません。
セットアップと起動
Python 3.10以上とOANDA Practice口座のAPIトークンを用意します。
python3 -m venv .venv
.venv/bin/pip install -e '.[dev]'
cp .env.sample .env
.envの次の2項目を設定します。
OANDA_ACCOUNT_ID=
OANDA_ACCESS_TOKEN=
最初は変更せずKFXAI_TRADING_MODE=paperで動かします。
set -a; source .env; set +a
kfxai-cycle
uvicorn kfxai.api:app --host 127.0.0.1 --port 18324
ダッシュボードはhttp://127.0.0.1:18324/です。常駐workerは次で起動します。
kfxai-worker
公開用PHPはpublic/kfxai.phpです。Webサーバから読み取り専用APIへ接続し、https://kurage.exbridge.jp/kfxai.phpで状態を表示します。
Dockerで起動する場合は以下です。APIとbrainはlocalhostだけに公開されます。
cp .env.sample .env
docker compose up --build
判断バックエンドAPI
自分で判断APIを提供する場合は次を起動します。
KFXAI_BRAIN_ENGINE=local_llm kfxai-brain
APIは127.0.0.1:18325で待ち受けます。公開時は認証、レート制限、x402決済を担当するゲートウェイを前段に置いてください。
GET /v1/health
GET /v1/meta
POST /v1/judge/regime
POST /v1/judge/directive
POST /v1/judge/postmortem
POST /v1/research/hypotheses
常駐運用
systemd/には次のunitがあります。
kfxai-api.service: 状態APIとダッシュボードkfxai-worker.service: 5分間隔の取引サイクルkfxai-brain.service: 判断APIkfxai-research.timer: 8時間ごとの改善仮説検証
インストール後はまずAPIとpaper workerだけを起動し、/api/statusの履歴と損益を確認してください。
テスト
.venv/bin/ruff check .
.venv/bin/pytest -q
テストはOANDAへ接続せず、疑似市場データと疑似API応答で価格解析、注文payload、リスクゲート、APIを確認します。
Kurage FX Brain 連携
kfxbrainはkfxaiのための有料FX判断APIです。tradingagents(Apache-2.0)・fingpt(MIT)・ai-hedge-fund(MIT)などのLLM知能をコミット固定・出典明記でvendor化し、FX向けの構造化APIとして公開します。通常は1回$0.05、マルチエージェント討論グラフ完全実行は$0.50。有料呼び出しはdeepseek、自前運用ではローカルgemma 4(ollama)を選択できます。支払いはx402でUSDC(Base)・JPYC(Polygon)・bankrに対応。判断のみを返し、ブローカー認証情報も注文実行APIも持ちません。
利用経路は、Coinbase CDP対応の直接x402(1回$0.05〜)、Bankr、Polygon上のJPYCです。RapidAPIはStudioへの製品登録済みですが、一般公開リスティングは準備中です。
バイブトレーディングとの関係
kfxaiはvibe-tradingをFXで実践した記録です。「仮説は人間、コードはAI、判定は数字」という分業に従い、AIの提案を鵜呑みにせず数字で検証します。LPでは、CodexやClaude Codeへの依頼例として「東京時間のレンジをブレイクしたら順張りで入る戦略を書いて。損切りはレンジ幅の半分で」という日本語の指示を挙げています。実践ツール一式の総まとめは「バイブトレーディング実践ガイド」にあります。
技術スタック
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で十分な期間検証し、スリッページ、通信障害、金利調整、税務を含めて評価してください。
関連ページ
- kurage-repos — README群の情報源
- kurage-lps — LP本文(本ページの情報源)
- kurage-articles-index — 関連記事一覧
- kurage-sites — 公開URL索引
- kfreqai — 暗号資産版の姉妹プロジェクト
- kfxbrain — FX判断API(頭脳)
- oanda — 価格・注文API提供元
- kurage-vtuber — キャラクター実行基盤
- exbridge — プロダクト公開元
- kurage-platform — プラットフォーム全体
- trust-boundary / x402 / local-llm / paper-trading / vibe-trading / ai-trading
Kurage.AI に質問する
