QuantDinger

🤖 AI-Native · 🔒 Privacy-First · 🚀 All-in-One Quant Workspace

The Next-Gen Local Quant Platform: Multi-Market Data, AI Research, Visual Backtesting, and Automated Trading.

Website · Live Demo · Report Bug · Discussions

---

📖 Introduction

QuantDinger is a Local-First quantitative trading workspace designed for traders, researchers, and geeks.

Unlike expensive SaaS platforms, QuantDinger returns data ownership to you. It features a built-in LLM-based Multi-Agent Research Team that autonomously gathers financial intelligence from the web, combines it with local market data, generates professional analysis reports, and seamlessly integrates with your strategy development, backtesting, and live trading workflows.

Core Value

• 🛡️ Privacy First: All strategies, trading logs, and API keys are stored locally in your SQLite database.
• 🧠 AI Empowered: Not just code completion, but a real AI Research Analyst (powered by OpenRouter/LLM).
• ⚡ Multi-Market: Native support for Crypto, US Stocks, CN/HK Stocks, Forex, and Futures.
• 🔌 Out-of-the-Box: One-click deployment via Docker. No complex environment setup required.

---

📸 Visual Tour

📊 Professional Quant Dashboard

Real-time monitoring of market dynamics, assets, and strategy status.

🤖 AI Deep Research Multi-agent collaboration for market sentiment & technical analysis.	💬 Smart Trading Assistant Natural language interface for instant market insights.
📈 Interactive Indicator Analysis Rich library of technical indicators with drag-and-drop analysis.	🐍 Python Strategy Gen Built-in editor with AI-assisted strategy coding.

---

✨ Key Features

1. Universal Data Engine

Stop worrying about data APIs. QuantDinger features a powerful Data Source Factory pattern:

• Crypto: Seamless integration with CCXT, supporting Binance, OKX, Bybit, and 100+ exchanges.
• Stocks: Integrates Yahoo Finance, Finnhub, Tiingo (US), and AkShare (CN/HK).
• Futures/Forex: Supports OANDA and major futures data sources.
• Proxy Support: Built-in proxy configuration for restricted network environments.

2. AI Multi-Agent Research

Your tireless team of analysts:

• Coordinator Agent: Decomposes tasks and manages workflows.
• Research Agent: Performs full-web searches (Google/Bing) for macro news.
• Crypto/Stock Agent: Specializes in technical and capital flow analysis for specific markets.
• Report Generation: Automatically produces structured Daily/Weekly research reports.

3. Robust Strategy Runtime

• Thread-Based Executor: Independent thread pool management for strategy execution.
• Auto-Restore: Automatically resumes running strategies after system restarts.
• Pending Order Worker: Reliable background queue ensures precise signal execution and prevents slippage.

4. Modern Tech Stack

• Backend: Python (Flask) + SQLite + Redis (Optional) — Simple, powerful, extensible.
• Frontend: Vue 2 + Ant Design Vue + KlineCharts/ECharts — Responsive and interactive.
• Deployment: Docker Compose orchestration.

---

🏦 Supported Exchanges

Powered by the robust CCXT library, we support nearly all major cryptocurrency exchanges:

Binance	OKX	Bybit	Bitget	Gate.io	KuCoin

Plus Kraken, Huobi, Coinbase Pro, and 100+ others.

---

Multi-Language Support

Show supported languages

QuantDinger is built for a global audience with comprehensive internationalization:

All UI elements, error messages, and documentation are fully translated. Language is auto-detected based on browser settings or can be manually switched in the app.

---

Supported Markets

Market Type	Data Sources	Trading
Cryptocurrency	Binance, OKX, Bitget, + 100 exchanges	✅ Full support
US Stocks	Yahoo Finance, Finnhub, Tiingo	✅ Via broker API
CN/HK Stocks	AkShare, East Money	⚡ Data only
Forex	Finnhub, OANDA	✅ Via broker API
Futures	Exchange APIs, AkShare	⚡ Data only

---

Architecture (Current Repo)

┌─────────────────────────────┐
│      quantdinger_vue         │
│   (Vue 2 + Ant Design Vue)   │
└──────────────┬──────────────┘
               │  HTTP (/api/*)
               ▼
┌─────────────────────────────┐
│     backend_api_python       │
│   (Flask + strategy runtime) │
└──────────────┬──────────────┘
               │
               ├─ SQLite (quantdinger.db)
               ├─ Redis (optional cache)
               └─ Data providers / LLMs / Exchanges

---

Repository Layout

.
├─ backend_api_python/         # Flask API + AI + backtest + strategy runtime
│  ├─ app/
│  ├─ env.example              # Copy to .env for local config
│  ├─ requirements.txt
│  └─ run.py                   # Entrypoint
└─ quantdinger_vue/            # Vue 2 UI (dev server proxies /api -> backend)

---

Quick Start

Option 1: Docker Deployment (Recommended)

The fastest way to get QuantDinger running.

1. Prepare Configuration

Linux/macOS:

cp docker.env.example backend_api_python/.env
nano backend_api_python/.env

Windows PowerShell:

Copy-Item docker.env.example backend_api_python/.env
notepad backend_api_python/.env

Required settings:

• SECRET_KEY - Application secret, use a random string
• ADMIN_USER / ADMIN_PASSWORD - Login credentials
• OPENROUTER_API_KEY - OpenRouter API key (required for AI analysis)

2. Build and Start

# Build images and start (first run)
docker-compose up -d --build

# Subsequent starts (no rebuild needed)
docker-compose up -d

3. Access the Application

• Frontend UI: http://localhost
• Backend API: http://localhost:5000

Docker Commands Reference

# View running status
docker-compose ps

# View logs
docker-compose logs -f

# View backend logs only
docker-compose logs -f backend

# View frontend logs only
docker-compose logs -f frontend

# Stop services
docker-compose down

# Stop and remove volumes (WARNING: deletes database!)
docker-compose down -v

# Restart services
docker-compose restart

# Rebuild and restart
docker-compose up -d --build

# Enter backend container
docker exec -it quantdinger-backend /bin/bash

# Enter frontend container
docker exec -it quantdinger-frontend /bin/sh

Docker Architecture

┌─────────────────┐     ┌─────────────────┐
│   Frontend      │     │    Backend      │
│   (Nginx)       │────▶│   (Python)      │
│   Port: 80      │     │   Port: 5000    │
└─────────────────┘     └─────────────────┘
        │                       │
        └───────────────────────┘
              Docker Network

• Frontend: Vue.js app served by Nginx, proxies API requests to backend
• Backend: Python Flask API service

Data Persistence

The following data is mounted to the host and persists across container restarts:

volumes:
  - ./backend_api_python/quantdinger.db:/app/quantdinger.db   # Database
  - ./backend_api_python/logs:/app/logs                       # Logs
  - ./backend_api_python/data:/app/data                       # Data directory
  - ./backend_api_python/.env:/app/.env                       # Configuration

Customization

Change ports - Edit docker-compose.yml:

services:
  frontend:
  ports:
    - "8080:80"  # Change to port 8080
  
  backend:
  ports:
    - "5001:5000"  # Change to port 5001

Configure HTTPS - Use a reverse proxy (like Caddy/Nginx):

# Using Caddy (automatic HTTPS)
caddy reverse-proxy --from yourdomain.com --to localhost:80

Production Recommendations

Security:

# Generate strong SECRET_KEY
openssl rand -hex 32

# Set secure admin password
ADMIN_PASSWORD=your-very-secure-password

Resource limits - Add to docker-compose.yml:

services:
  backend:
  deploy:
    resources:
    limits:
      cpus: '2'
      memory: 2G
    reservations:
      cpus: '0.5'
      memory: 512M

Log management:

services:
  backend:
  logging:
    driver: "json-file"
    options:
    max-size: "100m"
    max-file: "3"

Docker Troubleshooting

Frontend can't connect to backend:

docker-compose logs backend
curl http://localhost:5000/api/health

Database permission issues:

chmod 666 backend_api_python/quantdinger.db

Build failures:

# Clear Docker cache and rebuild
docker-compose build --no-cache

Out of memory:

# Check memory usage
docker stats

# Add swap space (Linux)
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

Updating

# Pull latest code
git pull

# Rebuild and restart
docker-compose up -d --build

Backup

# Backup database
cp backend_api_python/quantdinger.db backup/quantdinger_$(date +%Y%m%d).db

# Backup configuration
cp backend_api_python/.env backup/.env_$(date +%Y%m%d)

---

Option 2: Local Development

Prerequisites

• Python 3.10+ recommended
• Node.js 16+ recommended

1. Start the backend (Flask API)

cd backend_api_python
pip install -r requirements.txt
cp env.example .env   # Windows: copy env.example .env
python run.py

Backend will be available at http://localhost:5000.

2. Start the frontend (Vue UI)

cd quantdinger_vue
npm install
npm run serve

Frontend dev server runs at http://localhost:8000 and proxies /api/* to http://localhost:5000 (see quantdinger_vue/vue.config.js).

---

Configuration (.env)

Use backend_api_python/env.example as a template. Common settings include:

• Auth: SECRET_KEY, ADMIN_USER, ADMIN_PASSWORD
• Server: PYTHON_API_HOST, PYTHON_API_PORT, PYTHON_API_DEBUG
• Database: SQLITE_DATABASE_FILE (optional; default is backend_api_python/quantdinger.db)
• AI / LLM: OPENROUTER_API_KEY, OPENROUTER_MODEL, timeouts
• Web search: SEARCH_PROVIDER, SEARCH_GOOGLE_*, SEARCH_BING_API_KEY
• Proxy (optional): PROXY_PORT or PROXY_URL
• Workers: ENABLE_PENDING_ORDER_WORKER, DISABLE_RESTORE_RUNNING_STRATEGIES

---

API

The backend provides REST endpoints for login, market data, indicators, backtesting, strategies, and AI analysis.

• Health: GET /health (also supports GET /api/health for deployment probes)
• Auth (frontend-compatible): POST /api/user/login, POST /api/user/logout, GET /api/user/info

For the full route list, see backend_api_python/app/routes/.

---

License

Licensed under the Apache License 2.0. See LICENSE.

---

🤝 Community & Support

Join our global community for strategy sharing and technical support:

• Telegram (Official): t.me/worldinbroker
• Discord: Join Server
• YouTube: @quantdinger
• Email: brokermr810@gmail.com
• GitHub Issues: Report bugs / Request features

---

☕ Support the Project

If QuantDinger helps you profit, consider buying the developers a coffee. Your support keeps the project alive!

View Crypto Donation Addresses

ERC-20 / BEP-20 / Polygon / Arbitrum

0x96fa4962181bea077f8c7240efe46afbe73641a7

---

Commercial Services

Show services

We offer professional services to help you get the most out of QuantDinger:

Service	Description
Deployment & Setup	One-on-one assistance with server deployment, configuration, and optimization
Custom Strategy Development	Tailored trading strategies designed for your specific needs and markets
Enterprise Upgrade	Commercial license, priority support, and advanced features for businesses
Training & Consulting	Hands-on training sessions and strategic consulting for your trading team

Interested? Contact us via:

• 📧 Email: brokermr810@gmail.com
• 💬 Telegram: @worldinbroker

---

Acknowledgements

QuantDinger stands on the shoulders of great open-source projects:

Project	Description	Link
Flask	Lightweight WSGI web framework	flask.palletsprojects.com
flask-cors	Cross-Origin Resource Sharing extension	GitHub
Pandas	Data analysis and manipulation library	pandas.pydata.org
CCXT	Cryptocurrency exchange trading library	github.com/ccxt/ccxt
yfinance	Yahoo Finance market data downloader	github.com/ranaroussi/yfinance
akshare	China financial data interface	github.com/akfamily/akshare
requests	HTTP library for Python	requests.readthedocs.io
Vue.js	Progressive JavaScript framework	vuejs.org
Ant Design Vue	Enterprise-class UI components	antdv.com
KlineCharts	Lightweight financial charting library	github.com/klinecharts/KLineChart
Lightweight Charts	TradingView charting library	github.com/nicepkg/lightweight-charts
ECharts	Apache data visualization library	echarts.apache.org

Thanks to all maintainers and contributors across these ecosystems! ❤️