Kurage
Kurage WikiKurageナレッジベース
Kurage.AIに聞く →
ホーム › Wiki › プロダクト › Kurage FX AI Trade(kfxai)
プロダクト

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

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

信頼境界

kfxaiの判断レイヤーはKFXAI_JUDGMENT_BACKENDで選択します。

どの頭脳を選んでも、AI判断レイヤーは注文API、認証情報、注文数量を持ちません。最終的なリスク判定は自分で動かすOSS本体だけが行います。これはtrust-boundaryの典型的な実装です。OSS本体側には固定リスクゲート(スプレッド上限、日次損失上限、最大ポジション数、全注文への損切り・利確設定、SQLite取引ジャーナル)が組み込まれており、cloneすればLLMなしでもルールベースの頭脳でペーパートレードがそのまま動きます。判断APIを自前で提供する場合はKFXAI_BRAIN_ENGINE=local_llm kfxai-brainで起動します。

データが語ったこと:ML方向予測の棄却

このためkfxaiは機械学習の方向予測では取引しません。

生き残った戦略:東京レンジ→ロンドンブレイクアウト

取引モード

モード 価格 注文
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があります。

インストール後はまず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

注意事項

関連ページ

「Kurage FX AI Trade(kfxai)」についてもっと知りたいですか?
Kurage.AI に質問する