You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
feat(adapter): implement BaoStockAdapter for SSE & SZSE (#420)
## 📝 Pull Request Template
### 1. Related Issue
#196
Not resolved, just enhancement, 'Historical price data not available
for'SSE:000001' is fixed.
### 2. Type of Change (select one)
New Feature
### 3. Description
Add a more stable and free [datasource](http://www.baostock.com/) which
supports SSE & SZSE's stock and index.
(No real-time price because BaoStock does not support it).
**Be careful, one IP can only request APIs 100,000 times per day**(or
you will be blocked), but I didn't set a limit or use cache.
### 4. Testing
- [x] I have tested this locally.
- [ ] I have updated or added relevant tests.
### 5. Checklist
- [x] I have read the [Code of Conduct](./CODE_OF_CONDUCT.md)
- [x] I have followed the [Contributing Guidelines](./CONTRIBUTING.md)
- [x] My changes follow the project's coding style
---------
Co-authored-by: hazeone <709547807@qq.com>
Copy file name to clipboardExpand all lines: README.md
+54-80Lines changed: 54 additions & 80 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,6 +37,8 @@ ValueCell is a community-driven, multi-agent platform for financial applications
37
37
38
38
It provides a team of TOP investment Agents to help you with stock selection, research, tracking, and even trading.
39
39
40
+
The system keeps all your sensitive information stored locally on your device, ensuring core data security.
41
+
40
42
Welcome to join our Discord community to share feedback and issues you encounter, and invite more developers to contribute 🔥🔥🔥
41
43
42
44
>Note: ValueCell team members will never proactively contact community participants. This project is for technical exchange only. Investing involves risk. ⚠️
@@ -85,93 +87,27 @@ Welcome to join our Discord community to share feedback and issues you encounter
85
87
86
88
# Quick Start
87
89
88
-
## For Users
90
+
## New Users
89
91
90
92
To get started quickly, download the latest ValueCell application for MacOS or Windows from the [Releases page](https://github.com/ValueCell-ai/valuecell/releases) on GitHub. You may also download the application from our official website: [https://valuecell.ai](https://valuecell.ai).
91
93
92
94
After installation, please configure your preferred model provider before using ValueCell for the first time. Refer to the instructions in the application or documentation as needed.
93
95
94
-
## For Developers
95
-
ValueCell is a Python-based application featuring a comprehensive web interface. Follow this guide to set up and run the application efficiently.
96
-
97
-
### Prerequisites
98
-
99
-
For optimal performance and streamlined development, we recommend installing the following tools:
100
-
101
-
**[uv](https://docs.astral.sh/uv/getting-started/installation/)** - Ultra-fast Python package and project manager built in Rust
102
-
**[bun](https://github.com/oven-sh/bun#install)** - High-performance JavaScript/TypeScript toolkit with runtime, bundler, test runner, and package manager
Edit the `.env` file with your API keys and preferences. This configuration file is shared across all agents. See [Configuration Guide](docs/CONFIGURATION_GUIDE.md) for details.
120
-
121
-
## Configuration
122
-
123
-
More detailed configuration information can be found at [CONFIGURATION_GUIDE](./docs/CONFIGURATION_GUIDE.md)
124
-
125
-
### Model Providers
126
-
Configure your preferred model providers by editing the `.env` file:
127
-
128
-
-**Simple Setup**: Just configure the model provider's API Key
129
-
130
-
-**Advanced Configuration**: For research-type agents, you need to configure more environment variables. Please refer to the `.env.example` file for details.
131
-
132
-
-**Official Recommendation**: Configure OpenRouter + any supplier that provides embedding models. Reason: This enables quick model switching across providers and provides RAG+Memory AI capabilities
133
-
134
-
135
-
Choose your preferred models and providers based on your requirements and preferences.
136
-
137
-
## Running the Application
138
-
139
-
Launch the complete application (frontend, backend, and agents):
140
-
141
-
### Linux / Macos
142
-
```bash
143
-
bash start.sh
144
-
```
145
-
146
-
### Windows (PowerShell)
147
-
```powershell
148
-
.\start.ps1
149
-
```
150
-
151
-
## Accessing the Interface
152
-
153
-
-**Web UI**: Navigate to [http://localhost:1420](http://localhost:1420) in your browser
154
-
-**Logs**: Monitor application logs at `logs/{timestamp}/*.log` for detailed runtime information of backend services and individual agents
155
-
156
-
157
-
## Next Steps
158
-
159
-
Once the application is running, you can explore the web interface to interact with ValueCell's features and capabilities.
160
-
161
-
## Live Trading
96
+
### Live Trading
162
97
163
98
- Configure AI Models: Add your AI Model API Key through the web interface.
164
99
- Configure Exchanges: Set up Binance/HyperLiquid/OKX/Coinbase... API credentials
165
100
- Create Strategies: Combine AI model with exchange to create custom strategies
166
101
- Monitor & Control: Start/stop traders and monitor performance in real-time
102
+
- Note: Currently only supports contract trading (spot is implemented as 1X contracts), so please ensure your contract account has sufficient balance
167
103
168
-
### Supported Exchanges
104
+
####Supported Exchanges
169
105
170
106
| Exchange | Notes | Status |
171
107
| --- | --- | --- |
172
-
|**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 |
173
-
|**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 |
174
-
|**OKX**| Requires API Key, Secret, and Passphrase for authentication. Supports USDT-margined contracts. Trading pair format: `BTC/USDT`| ✅ Tested |
108
+
|**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`. Note: Ensure perpetual contract account balance is not 0. When applying for API, add IP whitelist by searching `My IP` in search engine| ✅ Tested |
109
+
|**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`). Configure with main wallet address + API wallet private key. Minimum 10U per trade| ✅ Tested |
110
+
|**OKX**| Requires API Key, Secret, and Passphrase (OKX account password) for authentication. Supports USDT-margined contracts. Trading pair format: `BTC/USDT`| ✅ Tested |
175
111
| Coinbase | Supports USDT-margined contracts. Coinbase International is not yet supported | 🟡 Partially Tested |
176
112
| Gate.io | Supports USDT-margined contracts. Requires API Key and Secret | 🟡 Partially Tested |
177
113
| MEXC | Supports USDT-margined contracts. Requires API Key and Secret | 🟡 Partially Tested |
@@ -188,26 +124,64 @@ Once the application is running, you can explore the web interface to interact w
188
124
- To ensure your account safety, you need to reset your API keys regularly.
189
125
190
126
---
127
+
191
128
**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 local data stores and start fresh:
192
-
- LanceDB directory (stored in your system application directory):
129
+
- LanceDB directory (stored in your system application directory, same path as `.env`):
We sincerely invite all developers to join our Discord discussion group, where we regularly share the community roadmap and upcoming contributor benefit plans.
208
146
209
147
Details on development processes and standards are provided below:[CONTRIBUTING.md](.github/CONTRIBUTING.md)
210
148
149
+
ValueCell is a Python-based application with a comprehensive web interface, supporting multi-platform deployment. Follow the configuration below to get started quickly.
0 commit comments