QuantDinger

A local-first quant research & trading workspace: market data, indicators, AI analysis, backtesting, and strategy execution in one place.

Website · Live Demo

---

This repository is intentionally simple (no PHP gateway): it contains one Python backend and one web UI.

• backend_api_python/: Flask API + strategy runtime + AI agents
• quantdinger_vue/: Vue 2 UI (Ant Design Vue based) with charts, backtests, and strategy management

This repo does not include real secrets. Configure API keys and credentials via .env / environment variables.

---

Why QuantDinger

• Local-first (SQLite) out of the box: no external database required to run a full workflow locally.
• AI research team in code: multi-agent analysis produces structured reports (with optional web search + LLMs).
• Multi-market data layer: a factory-based data source abstraction for crypto, US stocks, CN/HK stocks, forex, and futures.
• From signals to execution: strategy runtime + a pending-order worker to dispatch queued actions reliably.

---

Highlights (What You Get)

• Multi-market market data

  • Data source factory in backend_api_python/app/data_sources/.
  • Optional proxy support for restricted networks (see .env).

• AI multi-agent analysis

  • Coordinator + role agents in backend_api_python/app/services/agents/.
  • Optional web search (Google/Bing) and LLM access (OpenRouter).

• Indicator engine + backtesting

  • Indicator code storage with safe execution utilities.
  • Backtest endpoints + persisted run history (SQLite).

• Strategy runtime

  • Thread-based executor with startup auto-restore (configurable).
  • Background pending-order worker that polls queued orders and dispatches signals (can be disabled).

• Live trading integrations

  • Exchange execution adapters in backend_api_python/app/services/live_trading/ (CCXT-based where applicable).

• Local auth (single-user)

  • Simple login (/login) with env-configured admin credentials (JWT token).

---

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 (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
copy env.example .env   # Windows PowerShell users can use: Copy-Item 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
• Auth: POST /login, POST /logout, GET /info

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

---

License

Licensed under the Apache License 2.0. See LICENSE.

---

Acknowledgements

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

• Flask / flask-cors
• Pandas
• CCXT
• yfinance, akshare, requests
• Vue 2 and Ant Design Vue
• Charting libraries used in the UI (e.g., KlineCharts)

Thanks to maintainers and contributors across these ecosystems.