🍊 OrangeOracle

Next-Gen AI-Powered Quantitative Trading Platform

  ██████╗ ██████╗  █████╗ ███╗   ██╗ ██████╗ ███████╗     ██████╗ ██████╗  █████╗  ██████╗██╗     ███████╗
 ██╔═══██╗██╔══██╗██╔══██╗████╗  ██║██╔════╝ ██╔════╝    ██╔═══██╗██╔══██╗██╔══██╗██╔════╝██║     ██╔════╝
 ██║   ██║██████╔╝███████║██╔██╗ ██║██║  ███╗█████╗      ██║   ██║██████╔╝███████║██║     ██║     █████╗
 ██║   ██║██╔══██╗██╔══██║██║╚██╗██║██║   ██║██╔══╝      ██║   ██║██╔══██╗██╔══██║██║     ██║     ██╔══╝
 ╚██████╔╝██║  ██║██║  ██║██║ ╚████║╚██████╔╝███████╗    ╚██████╔╝██║  ██║██║  ██║╚██████╗███████╗███████╗
  ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝ ╚══════╝     ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚══════╝╚══════╝

🤖 AI decides · 💻 Code executes · 🚀 Production-grade quantitative system

English (current) · 中文 / Doc index

---

⚡ 30-Second Start

git clone https://github.com/ai-orangeoracle/orangeoracle.git && cd orangeoracle
cp config.toml.example config.toml && vim config.toml   # add API keys
make dev   # start desktop app (recommended)

⚠️ Read the Safety Statement before use. This project is AI-assisted and for learning and research only.

---

🧭 Navigation

✨ Features · 🚀 Quick Start · 📚 Docs · 🏗️ Architecture · 🛠️ Stack · 🤝 Contributing

📋 Overview

💡 In one line

AI decides · Code executes — Multi-model, multi-exchange, multi-timeframe quantitative trading system with Go + Wails + Vue cross-platform desktop and a clear four-layer architecture.

OrangeOracle combines LLMs, quantitative strategy, and risk control: multi-timeframe K-lines, technical indicators, AI decisions, and unified execution across exchanges. GoFrame four-layer architecture, Wails + Vue desktop, Deepseek / Qwen / Gemini (OpenAI-compatible), OKX / Binance / Hyperliquid via a unified interface, with strategy- and language-based prompt templates and risk controls.

🌟 Highlights

🎨 Visual	⚡ Performance	🔒 Safety	🧩 Modular
Wails + Vue cross-platform desktop	Go concurrency	Multi-layer risk control	Clear architecture
Real-time data visualization	API caching	Margin validation	Easy to extend

⭐ Why OrangeOracle?

Feature	Traditional systems	OrangeOracle
AI	❌ Fixed strategy	✅ Multi-model, score-based decisions
Exchanges	❌ Single exchange	✅ Unified API, multi-exchange
Risk	⚠️ Basic	✅ Multi-factor risk control
Prompts	❌ Not supported	✅ File-based templates by strategy and language (resource/template/prompts)
Architecture	⚠️ Tightly coupled	✅ Four-layer, maintainable
Performance	⚠️ Basic	✅ API cache, concurrent processing

🎯 Core strengths

🤖 AI	💰 Exchanges	📊 Analysis	🔒 Risk
Deepseek / Qwen / Gemini	OKX / Binance / Hyperliquid	MA·EMA·RSI·MACD	Margin·R:R
🧩 Templates	⚡ Performance	🏗️ 4-layer	Prompts by strategy & language

🔥 Technical highlights

• 🧠 Multi-AI decisions: Deepseek, Qwen, Gemini (OpenAI-compatible), single model per decision by performance score
• 🌐 Unified exchange interface: OKX, Binance, Hyperliquid via abstraction, easy to add more
• 📈 Multi-timeframe analysis: 4H, 1H, 15m K-lines for trend and structure
• 🎯 Risk control: Margin check, risk-reward validation, position management
• ⚡ Performance: API caching, concurrency, rate limiting to reduce API cost
• 🧩 Prompt templates: Loaded from resource/template/prompts by strategy and language, with trading variables
• 🏗️ Four-layer architecture: Core → Data → External → Business, maintainable and extensible

✨ Key features

🎨 Feature matrix

┌─────────────────────────────────────────────────────────────────┐
│                                                                  │
│  🤖 AI decisions  │  📊 Market data  │  💰 Execution  │  🔒 Risk  │
│  ─────────────────│  ─────────────── │  ───────────── │  ───────  │
│  • Multi-model    │  • Multi-TF      │  • Multi-exch   │  • Margin │
│  • Score-based    │  • Indicators   │  • Order mgmt   │  • R:R    │
│  • Prompt mgmt    │  • Real-time     │  • Pos sync     │  • Position│
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

🤖 AI decision engine

Feature	Description	Implementation
🧠 Multi-model	Deepseek, Qwen, Gemini; single model per decision by score	Performance score + single call
🔌 OpenAI-compatible	Any OpenAI-API-compatible provider	Unified SDK
🧩 Prompt templates	By strategy and language, trading variables injected	resource/template/prompts
🌐 i18n	EN/ZH UI and logs, configurable prompt language	i18n

📊 Market data & indicators

Feature	Description	Scope
⏰ Multi-timeframe	4H, 1H, 15m K-lines	Trend and structure
📈 Indicators	MA, EMA, RSI, MACD, Bollinger, ATR, etc.	Dozens of indicators
⚡ Real-time	Caching and refresh strategy	Lower API usage

💰 Multi-exchange execution

Feature	Description	Benefit
🌐 Unified API	One abstraction over multiple exchanges	Easy to add exchanges
📋 Orders	Limit, market, stop, take-profit	Full lifecycle
🔄 Position sync	Sync positions with exchanges	Data consistency

Supported: OKX, Binance, Hyperliquid · Extensible: any exchange

🔒 Risk control

┌─────────────────────────────────────────┐
│                                         │
│  💰 Margin check   →  Reduce blow-up   │
│  📊 Risk-reward    →  Safer trades     │
│  📦 Position mgmt  →  Limit leverage   │
│  👁️ Monitoring     →  Early warning    │
│                                         │
└─────────────────────────────────────────┘

⚡ Performance & reliability

Area	How	Effect
🚀 API cache	Contract info, funding rate, etc.	Fewer calls
⚡ Concurrency	Multiple AI calls, multi-exchange ops	Higher throughput
🌐 Proxy	Per-model HTTP proxy	Flexible AI access
📝 Logging	Decisions and executions	Debug and tune

📱 Cross-platform desktop

Platform	Status	Notes
🍎 macOS	✅	Native
🪟 Windows	✅	Full support
🐧 Linux	✅	Same experience

Stack: Wails + Vue · Features: Monitoring, charts, trading UI

🚀 Quick Start

See Quick Start Guide for requirements, config, and run steps.

📚 Documentation

📖 User docs

Doc	Description	Link
🚀 Quick Start	Install, config, run	View
📈 Trading Strategy	Strategies and params	View
📐 Trading Variables	Variables and config	View

🏗️ Architecture

Doc	Description	Link
📐 Architecture	Four-layer design	View

🔒 Safety

Doc	Description	Link
⚠️ Safety	Risks and disclaimer	View

🛠️ Development

Doc	Description	Link
🔧 AI registration	How AI services are registered	View
💰 Exchange / API	Exchange and API services	See subpackages under internal/service/external

🏗️ Architecture overview

GoFrame layering and four-layer services (Command → Controller → Logic → Service). See Architecture.

🛠️ Tech stack

🎯 Core

Layer	Tech	Notes
Backend	Go 1.21+	Concurrency, performance
Framework	GoFrame v2	Application framework
Database	SQLite	Main store + analytics
AI	Deepseek / Qwen / Gemini	OpenAI-compatible
Exchanges	OKX / Binance / Hyperliquid	Unified interface
Cache	go-cache	In-memory
Desktop	Wails + Vue	macOS / Windows / Linux
SDKs	OpenAI SDK, go-binance/v2	Third-party clients

🚀 Why this stack

• ⚡ Performance: Go concurrency, lightweight goroutines
• 🔒 Type safety: Strong typing, compile-time checks
• 📦 Modular: Clear boundaries, easy to extend
• 🌐 Cross-platform: Wails + Vue on macOS, Windows, Linux

🤝 Contributing

Contributions are welcome: code, docs, bug reports, or feature ideas.

📝 How to contribute

1. Fork the repo
2. Create a branch — git checkout -b feature/your-feature-name
3. Commit — git commit -m "Add some amazing feature"
4. Push — git push origin feature/your-feature-name
5. Open a PR on GitHub

⚠️ Notes

• ✅ All changes require review
• ✅ Ensure tests and docs are updated
• ✅ Follow project rules (see .cursorrules)

🎯 Areas to contribute

• 🐛 Bugs: Fix issues
• ✨ Features: New strategies, AI integrations, etc.
• 📚 Docs: Improve clarity and coverage
• 🎨 UI/UX: Wails + Vue improvements
• 🔧 Performance: Optimize speed and resource use

🙏 Acknowledgments

This project builds on the following:

🤖 AI & tools

Service	Description	Link
Cursor AI	AI-assisted editor used for development	Cursor
DeepSeek	LLM API	DeepSeek
Qwen	Alibaba Cloud AI	Tongyi
Gemini	Google multimodal AI	Gemini
OpenAI SDK	OpenAI-compatible Go SDK	GitHub

💰 Exchanges

Exchange	Description	Link
OKX	Global exchange API	OKX
Binance	go-binance/v2 SDK	Binance
Hyperliquid	Perp DEX API	Hyperliquid

🛠️ Frameworks & libs

Name	Description	Link
GoFrame	Go application framework	GoFrame
go-cache	In-memory cache	GitHub
SQLite	Embedded DB	SQLite
Wails + Vue	Desktop + UI	Wails / Vue

📄 License

This project is under the MIT License. See LICENSE.

MIT License — Use, modify, and distribute with attribution.

---

⚠️ Disclaimer

This project is for learning and research only and does not constitute investment advice. Trading risk is your own. See Safety Statement before use.

---

---

🌟 Support the project

⭐ If this project helps you, consider giving it a Star.

---

⭐ Like it? Star us

🍊 OrangeOracle — AI decides, code executes · Last update 2025-02