Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 28 additions & 6 deletions README.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -143,12 +143,34 @@ bash start.sh

アプリケーションが起動したら、WebインターフェースでValueCellの機能を操作して探索できます。

## リアルタイム取引 (OKX/Binance)

- 配AIモデルの設定: Webインターフェースから AI モデルの API キーを追加.
- 取引所の設定: OKX / Binance の API 認証情報を設定
- ストラテジー作成: AIモデルと取引所を組み合わせてカスタム戦略を作成
- モニタリング&コントロール: 戦略の開始/停止を行い、パフォーマンスをリアルタイムで監視
## リアルタイム取引

- AIモデルの設定: Webインターフェースから AI モデルの API キーを追加します。
- 取引所の設定: Binance/HyperLiquid/OKX/Coinbase... の API 認証情報を設定します。
- ストラテジー作成: AIモデルと取引所を組み合わせてカスタム戦略を作成します。
- モニタリング&コントロール: 戦略の開始/停止を行い、パフォーマンスをリアルタイムで監視します。

### サポートされている取引所

| 取引所 | 備考 | ステータス |
| --- | --- | --- |
| **Binance** | 国際サイト [binance.com](binance.com) のみサポート(米国サイトは非対応)。USDT-M 先物(USDT証拠金契約)を使用します。先物口座に十分な USDT 残高があることを確認してください。取引ペア形式: `BTC/USDT` | ✅ テスト済み |
| **Hyperliquid** | 証拠金通貨として USDC のみサポートします。メインウォレットアドレス + API ウォレット秘密鍵認証を使用します([APIタブ](https://app.hyperliquid.xyz/API)から申請)。成行注文は自動的に IoC 指値注文に変換されます。取引ペア形式は手動で `SYMBOL/USDC` に調整する必要があります(例: `WIF/USDC`)。 | ✅ テスト済み |
| **OKX** | 認証には API Key、Secret、Passphrase が必要です。USDT証拠金契約をサポートします。取引ペア形式: `BTC/USDT` | ✅ テスト済み |
| Coinbase | USDT証拠金契約をサポートします。Coinbase International はまだサポートされていません。 | 🟡 部分的にテスト済み |
| Gate.io | USDT証拠金契約をサポートします。API Key と Secret が必要です。 | 🟡 部分的にテスト済み |
| MEXC | USDT証拠金契約をサポートします。API Key と Secret が必要です。 | 🟡 部分的にテスト済み |
| Blockchain | USDT証拠金契約をサポートします。API Key と Secret が必要です。 | 🟡 部分的にテスト済み |

**凡例**:
- ✅ **テスト済み**: 本番環境で完全にテストおよび検証済み
- 🟡 **部分的にテスト済み**: コードの実装は完了していますが、完全にはテストされておらず、デバッグが必要な場合があります
- **推奨**: 完全にテストされた取引所(Binance, Hyperliquid, OKX)を優先的に使用してください

### 注意事項
- 現在はレバレッジ取引のみをサポートしているため、Perps(無期限先物)アカウントに十分な残高があることを確認する必要があります。
- 資金の損失を防ぐため、API シークレットは安全に保管する必要があります。アプリはシークレットをデバイス上にローカルに保存し、インターネット経由で第三者に送信することはありません。
- アカウントの安全を確保するために、API キーを定期的にリセットする必要があります。

---
**注意**: アプリケーションを実行する前に、すべての前提条件がインストールされ、環境変数が適切に設定されていることを確認してください。
Expand Down
28 changes: 25 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -151,15 +151,37 @@ bash start.sh

Once the application is running, you can explore the web interface to interact with ValueCell's features and capabilities.

## Live Trading (OKX/Binance)
## Live Trading

- Configure AI Models: Add your AI Model API Key through the web interface.
- Configure Exchanges: Set up OKX/Binance API credentials
- Configure Exchanges: Set up Binance/HyperLiquid/OKX/Coinbase... API credentials
- Create Strategies: Combine AI model with exchange to create custom strategies
- Monitor & Control: Start/stop traders and monitor performance in real-time

### Supported Exchanges

| Exchange | Notes | Status |
| --- | --- | --- |
| **Binance** | Only supports international site [binance.com](binance.com), not US site. Uses USDT-M futures (USDT-margined contracts). Ensure your futures account has sufficient USDT balance. Trading pair format: `BTC/USDT` | ✅ Tested |
| **Hyperliquid** | Only supports USDC as margin currency. Uses your main wallet address + API wallet private key authentication (use [API tab](https://app.hyperliquid.xyz/API) to apply). Market orders are automatically converted to IoC limit orders. Trading pair format must be manually adjusted to `SYMBOL/USDC` (e.g., `WIF/USDC`) | ✅ Tested |
| **OKX** | Requires API Key, Secret, and Passphrase for authentication. Supports USDT-margined contracts. Trading pair format: `BTC/USDT` | ✅ Tested |
| Coinbase | Supports USDT-margined contracts. Coinbase International is not yet supported | 🟡 Partially Tested |
| Gate.io | Supports USDT-margined contracts. Requires API Key and Secret | 🟡 Partially Tested |
| MEXC | Supports USDT-margined contracts. Requires API Key and Secret | 🟡 Partially Tested |
| Blockchain | Supports USDT-margined contracts. Requires API Key, Secret | 🟡 Partially Tested |

**Legend**:
- ✅ **Tested**: Fully tested and verified in production environment
- 🟡 **Partially Tested**: Code implementation complete but not fully tested, may require debugging
- **Recommended**: Prioritize using fully tested exchanges (Binance, Hyperliquid, OKX)

### Notice
- Currently supports leverage trading only, so you need to ensure your Perps account has sufficient balance.
- You must keep your API secrets secure to avoid losing funds. The app stores secrets locally on your device and will not send them to any third party over the internet.
- To ensure your account safety, you need to reset your API keys regularly.

---
**Note**Before running the application, ensure all prerequisites are installed and environment variables are properly configured. If it has been a long time since the last update, you can delete the database files in the project`lancedb/`,`valuecell.db`, `.knowledgebase/`and start again
**Note**: Before running the application, ensure all prerequisites are installed and environment variables are properly configured. If it has been a long time since the last update, you can delete the database files in the project directories: `lancedb/`, `valuecell.db`, `.knowledgebase/` and start fresh

# Developers

Expand Down
30 changes: 26 additions & 4 deletions README.zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -150,12 +150,34 @@ bash start.sh

应用运行后,你可以通过网页界面探索并使用 ValueCell 的各项功能和能力。

## 实盘交易 (OKX/Binance)
## 实盘交易

- 配置 AI 模型: 通过网页UI界面添加你的 AI模型 API Key.
- 配置交易所: 设置 OKX / Binance 的 API 凭证
- 配置 AI 模型: 通过网页UI界面添加你的 AI 模型 API Key
- 配置交易所: 设置 Binance/HyperLiquid/OKX/Coinbase... API 凭证
- 创建策略: 将 AI 模型与交易所组合,创建自定义交易策略
- 监控与控制: 实时启动/停止策略,并监控交易表现
- 监控与控制: 实时启动/停止策略,并实时监控交易表现

### 支持的交易所

| 交易所 | 说明 | 状态 |
| --- | --- | --- |
| **Binance** | 仅支持国际站 [binance.com](binance.com),不支持美国站。使用 USDT-M 合约(USDT 本位合约)。请确保您的合约账户有足够的 USDT 余额。交易对格式:`BTC/USDT` | ✅ 已测试 |
| **Hyperliquid** | 仅支持 USDC 作为保证金货币。使用您的主钱包地址 + API 钱包私钥认证(使用 [API 页面](https://app.hyperliquid.xyz/API) 申请)。市价单会自动转换为 IoC 限价单。交易对格式必须手动调整为 `SYMBOL/USDC`(例如 `WIF/USDC`) | ✅ 已测试 |
| **OKX** | 需要 API Key、Secret 和 Passphrase 进行认证。支持 USDT 本位合约。交易对格式:`BTC/USDT` | ✅ 已测试 |
| Coinbase | 支持 USDT 本位合约。Coinbase International 尚未支持 | 🟡 部分测试 |
| Gate.io | 支持 USDT 本位合约。需要 API Key 和 Secret | 🟡 部分测试 |
| MEXC | 支持 USDT 本位合约。需要 API Key 和 Secret | 🟡 部分测试 |
| Blockchain | 支持 USDT 本位合约。需要 API Key 和 Secret | 🟡 部分测试 |

**图例**:
- ✅ **已测试**: 在生产环境中经过充分测试和验证
- 🟡 **部分测试**: 代码实现已完成但未完全测试,可能需要调试
- **推荐**: 优先使用经过充分测试的交易所(Binance, Hyperliquid, OKX)

### 注意事项
- 目前仅支持杠杆/合约交易,因此您需要确保您的永续合约(Perps)账户有足够的余额。
- 您必须妥善保管您的 API 密钥以避免资金损失。该应用程序将密钥本地存储在您的设备上,不会通过互联网发送给任何第三方。
- 为了确保您的账户安全,您需要定期重置您的 API 密钥。

---

Expand Down
30 changes: 26 additions & 4 deletions README.zh_Hant.md
Original file line number Diff line number Diff line change
Expand Up @@ -147,12 +147,34 @@ bash start.sh

應用程式啟動後,你可以透過網頁介面探索並使用 ValueCell 的各項功能與能力

## 实盘交易 (OKX/Binance)
## 實盤交易

- 配置 AI 模型: 透過網頁介面新增你的 AI 模型 API Key
- 配置交易所: 設定 OKX / Binance 的 API 憑證
- 配置 AI 模型: 透過網頁介面新增你的 AI 模型 API Key
- 配置交易所: 設定 Binance/HyperLiquid/OKX/Coinbase... API 憑證
- 建立策略: 將 AI 模型與交易所組合,建立自訂交易策略
- 監控與控制: 实时启动/停止策略,并监控交易表现
- 監控與控制: 透過即時監控啟動/停止策略,並監控交易表現

### 支援的交易所

| 交易所 | 說明 | 狀態 |
| --- | --- | --- |
| **Binance** | 僅支援國際站 [binance.com](binance.com),不支援美國站。使用 USDT-M 合約(USDT 本位合約)。請確保您的合約帳戶有足夠的 USDT 餘額。交易對格式:`BTC/USDT` | ✅ 已測試 |
| **Hyperliquid** | 僅支援 USDC 作為保證金貨幣。使用您的主錢包地址 + API 錢包私鑰認證(使用 [API 頁面](https://app.hyperliquid.xyz/API) 申請)。市價單會自動轉換為 IoC 限價單。交易對格式必須手動調整為 `SYMBOL/USDC`(例如 `WIF/USDC`) | ✅ 已測試 |
| **OKX** | 需要 API Key、Secret 和 Passphrase 進行認證。支援 USDT 本位合約。交易對格式:`BTC/USDT` | ✅ 已測試 |
| Coinbase | 支援 USDT 本位合約。Coinbase International 尚未支援 | 🟡 部分測試 |
| Gate.io | 支援 USDT 本位合約。需要 API Key 和 Secret | 🟡 部分測試 |
| MEXC | 支援 USDT 本位合約。需要 API Key 和 Secret | 🟡 部分測試 |
| Blockchain | 支援 USDT 本位合約。需要 API Key 和 Secret | 🟡 部分測試 |

**圖例**:
- ✅ **已測試**: 在生產環境中經過充分測試和驗證
- 🟡 **部分測試**: 程式碼實作已完成但未完全測試,可能需要除錯
- **推薦**: 優先使用經過充分測試的交易所(Binance, Hyperliquid, OKX)

### 注意事項
- 目前僅支援槓桿/合約交易,因此您需要確保您的永續合約(Perps)帳戶有足夠的餘額。
- 您必須妥善保管您的 API 密鑰以避免資金損失。該應用程式將密鑰本地儲存在您的裝置上,不會透過網際網路發送給任何第三方。
- 為了確保您的帳戶安全,您需要定期重設您的 API 密鑰。

---

Expand Down
66 changes: 0 additions & 66 deletions python/valuecell/agents/auto_trading_agent/__init__.py

This file was deleted.

11 changes: 0 additions & 11 deletions python/valuecell/agents/auto_trading_agent/__main__.py

This file was deleted.

Loading