Freqtrade / FreqAI
Freqtradeは暗号資産自動売買のOSSトレーディングボット。FreqAI機械学習拡張を持ち、kfreqaiの基盤となるGPL-3.0の製品。
Freqtrade は、暗号資産(仮想通貨)の自動売買を行うオープンソースのトレーディングボットです。FreqAI はその機械学習拡張で、LightGBMベースの価格予測エンジンを提供します。kfreqai の基盤として利用されています。GPL-3.0で公開されるフレームワークで、注文・取引所認証・ポジションサイズなどの実行層は利用者側の運用に残ります。
kfreqaiとの関係
- kfreqai は Freqtrade と FreqAI (LightGBM) の上に構築されたAI暗号資産取引システムです。
- kfreqai 独自のリスク管理層(過熱フィルタ、ペアBAN、ボラティリティ調整ポジションサイズ、レジーム対応スロットキャップ)が FreqAI の予測エンジンに重なります。
- 上流の Freqtrade は
vendor/freqtradeにGitサブモジュールとして参照配置されます。ただし実行時のdocker-compose.ymlは公式freqtradeorg/freqtrade:stable_freqaiイメージを使うため、vendor/freqtrade内のコードはコンテナに一切マウントされず、読み書きされるのはuser_data/だけです(Freqtrade attribution & license)。 - kfreqai は「オープンコア+メータードブレイン」構成で、倉庫のままではLLM・GPU・APIキー不要で動作。判断レイヤーは
KFREQAI_JUDGMENT_BACKENDでrule_based/x402/local_llmを切替可能です。 - kfreqai のダッシュボードは Freqtrade 自身のREST API (ポート18313、公式・無改変イメージ) と通信します。
特徴
- オープンソースのトレーディングボットフレームワーク
- FreqAI による機械学習ベースの価格予測(各キャンドルごとにペアごとの短期的値動き予測)。テクニカル指標に加え、BTC/ETHとの相関特徴量で市場全体の文脈を加味します
- 公式Dockerイメージを基本とし、上流コードをサブモジュール参照に留めるクリーンな実行構成
- paper-trading によるドライラン運用に対応(kfreqai の現行運用モード)
- GPL-3.0。注文・取引所認証・ポジションサイズ・固定リスク制限は利用者側のGPL本体に残り、外部のAIは判断だけを返す設計と整合
kfreqaiでの運用実績
- kfreqai では MEXC現物・5分足・約130銘柄を対象に、銘柄ごとに12時間おきの再学習を実施。
- 予測目標は「利確ライン(+1%)と損切りライン(-1%)、どちらに先に触れるか」を直接当てるトリプルバリア分類。
- 677,729予測点の較正監査で過学習を数値特定し、正則化済みのモデルが稼働。
- 当初は正則化なしのLightGBMによる丸暗記で「92%勝てる」と言いながら実際は42%しか当たらない状態だったが、木を浅くしearly stoppingを入れた正則化で検証ライン初の30日窓黒字(+1,100 USDT・勝率60.3%)に到達。
- 学習・予測を担う FreqAI と、地合い・リスク指示・取引後レビュー・改善仮説のLLMループを組み合わせた4ループ運用が行われています(予測、レジーム認識、リスクディレクティブ、ポストモーテム&リサーチ)。
関連する技術記事と知見
kurage-articles-index には Freqtrade/FreqAI を題材にした以下の記事が含まれており、このOSSが実験基盤として広く使われていることが分かります。
- FreqAIボットに「自己反省・自己改良」のLLM3層を実装 — 制約付き仮説DSLと自動バックテストの設計。LLMによる自己改良ループをFreqtrade上に載せる試み。
- 「出口をいくら弄っても黒字にならない」ボットの本丸は特徴量だった — FreqAIに3本目の相関ペアを追加したことで赤字が黒字に反転。モデル内部の特徴量設計が収益性の本丸であることを示す。
- 「勝率65%なのに負けている」 — kfreqai の
entry_thresholdを検証し、勝率と収益性が乖離する罠を可視化。 - 「勝てるbotは売らない」 — Freqtrade 等のトレーディングOSSはコードをオープンにしつつ、「判断」だけを x402 で従量課金するビジネスモデル(ai-trading)。
関連リンク
Related Documents
「Freqtrade / FreqAI」についてもっと知りたいですか?
Kurage.AI に質問する
Kurage.AI に質問する
