bitFlyer取引所向けの暗号通貨取引ボット
This logo was created by gopherize.me.
gogocoinは、bitFlyer暗号通貨取引所向けのGo言語製自動取引ボットです。EMAベースのスキャルピング戦略を使用し、設定可能な取引頻度で自動取引を実行します。
- プラガブル戦略アーキテクチャ:
pkg/strategy.Strategyインターフェースを実装することで独自の取引戦略を差し込み可能 - 同梱デフォルト戦略: EMAクロスオーバー + RSI フィルタによるスキャルピング戦略
- リスク管理（利確・ストップロス・1日の取引回数制限・クールダウン）
- WebUIによる取引の開始・停止制御
- WebSocketによるリアルタイム市場データ取得・分析
- WebダッシュボードによるリアルタイムモニタリングUI（
http://localhost:8080） - SQLiteによるデータ永続化
- 取引データの自動クリーンアップ（
retention_daysで保持日数を設定可能） - 構造化ログ（レベル別・カテゴリ別フィルタリング対応）
- 24/7稼働対応（冪等性・再起動耐性）
- 言語: Go 1.23以上（開発環境: Go 1.25.0）
- 依存関係: 最小限（go-bitflyer-api-client + yaml.v3 + sqlite3のみ）
- アーキテクチャ: レイヤー分離されたモジュラーアーキテクチャ
- 公開API (
pkg/):pkg/engine.Run()+pkg/strategy.Strategyインターフェースにより外部リポジトリからの戦略差し込みが可能。セマンティックバージョニング対象の安定API - データベース: SQLite（軽量・埋め込み・外部DB不要）
- DB保持:
retention_daysで設定可能（デフォルト1日） - 過去データ: bitFlyerで確認可能
- DB保持:
- 並行処理: Goroutines + Channels による非同期ワーカー
- 通信: WebSocket（リアルタイム） + REST API（Web UI）
- ログ: 標準log/slogベースの構造化ログ
- 高頻度ログフィルタリング（DEBUGレベル・dataカテゴリの2種類）
- DBインデックス最適化（timestamp DESC）
- パフォーマンス最適化:
- バランスキャッシュ（60秒TTL、APIコール90%削減）
- 429エラー98%削減
- デッドロック防止設計
- デプロイ: 埋め込みWebアセット付きシングルバイナリ
- 品質保証:
- 静的解析ツール対応（golangci-lint）
- 複数パッケージにわたるユニットテスト
- モジュラーアーキテクチャ（レイヤー分離設計）
- 型安全性（Go言語の型システム活用）
- エラーハンドリング（適切な例外処理）
重要: 必ずお読みください
このソフトウェアは情報提供および開発目的でのみ提供されており、金融アドバイスや投資判断を構成することを意図していません。暗号通貨取引は高リスクであり、投資元本を失う可能性があります。
実際の取引成績は市場環境、設定、タイミング等により大きく変動します。過去のバックテスト結果やシミュレーション結果は将来の成績を保証するものではありません。
このソフトウェアの使用により生じるいかなる損失や損害についても、作者は一切の責任を負いません。ご自身の判断と責任において使用してください。
このライブラリはbitFlyerと一切関係ありません。使用前に各APIプロバイダーの利用規約を確認してください。
このライブラリは「現状のまま」提供され、正確性、完全性、将来の互換性についていかなる保証もありません。
- Docker と Docker Compose
- bitFlyer APIキー（管理画面で取得）
ローカル開発（Docker なし）の場合は Go 1.25.0 以上が必要です。
# 1. リポジトリのクローン
git clone https://github.com/bmf-san/gogocoin.git
cd gogocoin
# 2. 環境変数の設定
cp .env.example .env
# .envファイルを編集してAPIキーを設定
# 3. 設定ファイルの作成
make init
# 4. 起動
make up
# 5. Web UIにアクセス
open http://localhost:8080
BITFLYER_API_KEY=your_actual_api_key_here
BITFLYER_API_SECRET=your_actual_api_secret_here
# ログを確認
make logs
# または: docker compose logs -f
# 停止
make down
# または: docker compose down
# 再起動
make restart
# または: docker compose restart
# イメージ再ビルド
make rebuild
# または: docker compose up -d --build
# 起動
make up
# ログ確認
make logs
# 停止
make down
# 再起動
make restart
# 再ビルド
make rebuild
ブラウザで取引状況をリアルタイム監視できます: http://localhost:8080
取引の開始・停止もWeb UIから操作できます。詳細は機能一覧を参照してください。
| ドキュメント | 内容 |
|---|---|
| docs/CONFIG.md | 設定リファレンス |
| docs/STRATEGY.md | 取引戦略リファレンス（プラガブルアーキテクチャ概要・同梱戦略一覧） |
| docs/DESIGN_DOC.md | アーキテクチャ設計ドキュメント（カスタム戦略の実装方法 § 5） |
| docs/DATA_MANAGEMENT.md | データ管理リファレンス |
| docs/openapi.yaml | API仕様（OpenAPI 3.1） |
- Docker volume で
./data/を永続化（設定済み） - 週1回程度の再起動で安定性向上
- ログレベルは
infoを推奨（debugは開発時のみ）
- ログ確認:
make logsまたはdocker compose logs -f - DB状態確認:
ls -lh ./data/gogocoin.db - コンテナ再起動:
make restart
# 依存関係インストール
make deps
# 開発ツールインストール（golangci-lint・oapi-codegen 等）
make install-tools
# テスト実行
make test
# カバレッジ確認
make test-coverage
# コードフォーマット
make fmt
# リンター実行
make lint
# Docker経由で実行
make up
docs/openapi.yaml を変更した場合は、oapi-codegen でコードを再生成してコミットしてください。
# api.gen.go を再生成
make generate
internal/api/api.gen.goは自動生成ファイルです。直接編集せず、必ずmake generate経由で更新してください。 CI のcodegenジョブが spec と生成コードの同期を検証します。
- gogocoin-vps-template — VPS（ConoHa 等）に systemd + GitHub Actions でデプロイする運用構成のテンプレート
CONTRIBUTING.md を参照してください。