local_fire_departmentHoneystax
search⌘K
loginLog Inperson_addSign Up
layers
HONEYSTAX TERMINAL v1.0
HomeNewsSavedSubmit
Back to the live board
Q

QuantDinger

Agent

AI-driven, local-first quantitative trading platform for research, backtesting and live execution. Python-native, pri...

Copy the install, test the workflow, then decide if it earns a permanent slot.

1,039
Why nowMoving now

Fresh repo activity plus visible builder pull. This is the kind of tool people test before it turns obvious.

DecisionHigh-conviction move

Copy the install, test the workflow, then decide if it earns a permanent slot.

Trial costDeep lift

This wants more setup and more teardown. Run it only if the upside is clear.

Risk14/100

GitHub health 100/100. no security policy. Fresh enough repo health and manageable issue load keep the risk controlled.

What You Are Adopting

AI Agent

Universal

Model

Multiple

Build Time

Minutes

Test This In Your Stack

One command inClean rollbackLow commitment
shieldSandboxedInstalls to ~/.claude — isolated from your projects. One command to remove.

Fastest way to find out if QuantDinger belongs in your setup.

Copy the install command, run a real test, and back it out cleanly if it slows you down.

Try now
git clone https://github.com/brokermr810/QuantDinger ~/.claude/agents/quantdinger

Run this first. You will know quickly if the workflow earns a permanent slot.

Back out
rm -rf ~/.claude/agents/quantdinger

No messy cleanup loop. If it misses, remove it and keep moving.

Install Location

~/  └─ .claude/      ├─ commands/      ├─ agents/      │   └─ quantdinger/ ← installs here      └─ settings.json

About

AI-driven, local-first quantitative trading platform for research, backtesting and live execution. Python-native, privacy-first, open source.. An open-source agent for the AI coding ecosystem.

README

QuantDinger Logo

QuantDinger

AI-Native Quantitative Trading Platform

Vibe Coding Meets Algo Trading

🇨🇳 中文  ·  🇺🇸 English

🌐 Live Demo  ·  📺 Video  ·  💬 Community  ·  🚀 Quick Start

7 AI Agents · Python Strategies · 10+ Exchanges · Prediction Markets · Your Server, Your Keys

Describe your trading idea in natural language → AI writes the Python strategy → Backtest → Live trade.
Zero coding required. Self-hosted — your API keys and strategies never leave your machine.

License Version Python Docker Vibe Coding Stars

Telegram Discord X

🇺🇸 English · 🇨🇳 简体中文 · 🇹🇼 繁體中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇩🇪 Deutsch · 🇫🇷 Français · 🇹🇭 ไทย · 🇻🇳 Tiếng Việt · 🇸🇦 العربية


📑 Table of Contents

  • 🚀 Quick Start (2 Minutes)
  • 🎯 Why QuantDinger?
  • 📸 Visual Tour
  • ✨ Key Features
  • 🔌 Supported Exchanges & Brokers
  • 🏗️ Architecture & Configuration
  • 📚 Documentation Index
  • 💼 License & Commercial
  • 🤝 Community & Support

🚀 Quick Start (2 Minutes)

Only need: Docker installed. Nothing else.

# 1. Clone
git clone https://github.com/brokermr810/QuantDinger.git
cd QuantDinger

# 2. Configure (edit admin password & AI API key)
cp backend_api_python/env.example backend_api_python/.env

# 3. Launch!
docker-compose up -d --build

Windows PowerShell: use Copy-Item backend_api_python\env.example -Destination backend_api_python\.env

🎉 Done! Open http://localhost:8888 | Login: quantdinger / 123456

📝 Key settings in backend_api_python/.env
# Required — Change for production!
ADMIN_USER=quantdinger
ADMIN_PASSWORD=your_secure_password
SECRET_KEY=your_random_secret_key

# Optional — Enable AI features (pick one)
OPENROUTER_API_KEY=your_key        # Recommended: 100+ models
OPENAI_API_KEY=your_key            # GPT-4o
DEEPSEEK_API_KEY=your_key          # Cost-effective
GOOGLE_GEMINI_API_KEY=your_key     # Gemini
🔧 Common Docker Commands
docker-compose ps                  # View service status
docker-compose logs -f backend     # View backend logs (real-time)
docker-compose restart backend     # Restart backend only
docker-compose up -d --build       # Rebuild & restart all
docker-compose down                # Stop all services

Update to latest version:

git pull && docker-compose up -d --build

Backup & Restore database:

docker exec quantdinger-db pg_dump -U quantdinger quantdinger > backup.sql
cat backup.sql | docker exec -i quantdinger-db psql -U quantdinger quantdinger

Custom port — create .env in project root:

FRONTEND_PORT=3000          # Default: 8888
BACKEND_PORT=127.0.0.1:5001 # Default: 5000

🎯 Why QuantDinger?

Vibe Coding for Trading — Describe your trading idea in plain English (or any language). AI writes the Python strategy, backtests it, and deploys it to live markets. No manual coding. No SaaS lock-in. Everything runs on your own server.

🎵 Vibe Coding Describe ideas in natural language → AI generates production-ready Python strategies
🔒 100% Self-Hosted API keys & strategies never leave your server — privacy by design
🤖 7 AI Agents Multi-agent research team: parallel analysis → debate → trade decision
🐍 Python-Native Full ecosystem (Pandas, NumPy, TA-Lib, scikit-learn) — no proprietary language limits
📊 Professional Charts K-line charts with Python indicators, real-time visualization
🌍 Crypto + Stocks + Forex 10+ exchanges, IBKR, MT5 — all in one platform
📊 Prediction Markets On-demand AI analysis for Polymarket — probability divergence, opportunity scoring
💰 Monetization-Ready Membership, credits, USDT on-chain payment — built-in
⚡ 2-Minute Deploy docker-compose up -d — production-ready, zero build

📸 Visual Tour  |  📺 Watch Video Demo

Video Demo
Dashboard
📊 Professional Quant Dashboard
AI Analysis
🤖 AI Deep Research
Trading Assistant
💬 Smart Trading Assistant
Indicator Analysis
📈 Indicator Analysis
Code Generation
🐍 AI Strategy Coding
Portfolio Monitor
📊 Portfolio Monitor

✨ Key Features

🎵 Vibe Coding Strategy Workbench

No coding required. Tell AI what you want in natural language — it generates production-ready Python strategies. Or write your own with the full Python ecosystem (Pandas, NumPy, TA-Lib, scikit-learn). Visualize everything on professional K-line charts.

💬 "I want a MACD crossover strategy with RSI filter on BTC 15min"
    ↓ AI generates Python code
    ↓ 📈 Visualize on K-line charts
    ↓ 🔄 Backtest with rich metrics
    ↓ 🤖 AI suggests optimizations
    ↓ 🚀 One-click deploy to live trading

🤖 7-Agent AI Analysis Engine

Not just one AI call. QuantDinger deploys 7 specialized agents that collaborate like a research team — analyze, debate, and reach consensus:

Phase 1 (Parallel):  📊 Technical · 📑 Fundamental · 📰 News · 💭 Sentiment · ⚠️ Risk
Phase 2 (Debate):    🐂 Bull vs 🐻 Bear — structured argumentation
Phase 3 (Decision):  🎯 TraderAgent → BUY / SELL / HOLD (with confidence %)
  • 🎵 Natural Language Analysis — Ask "Analyze BTC trend for next week" → 7 agents deliver a full report
  • 📡 AI Trading Radar — Auto-scans Crypto/Stocks/Forex hourly, surfaces opportunities
  • ⚡ Quick Trade Panel — See a signal? One-click to execute. No page switching.
  • 🧠 Memory-Augmented — Agents learn from past analyses (local RAG, not cloud)
  • 🔌 5+ LLM Providers: OpenRouter (100+ models), OpenAI, Gemini, DeepSeek, Grok
  • 📊 Polymarket Prediction Markets — On-demand AI analysis for prediction markets. Input a market link or title → AI analyzes probability divergence, opportunity score, and trading recommendations. Full history tracking and billing integration.

📈 Full Trading Lifecycle

Step What Happens
1. 💬 Describe Tell AI your trading idea in natural language — or write Python directly
2. 🤖 Generate AI creates the indicator & strategy code for you
3. 📊 Visualize See signals on professional K-line charts instantly
4. 🔄 Backtest Rich metrics + AI analyzes results & suggests improvements
5. 🚀 Execute Live trade on 10+ crypto exchanges, IBKR (stocks), MT5 (forex)
6. 📡 Monitor Portfolio tracker, alerts via Telegram/Discord/Email/SMS/Webhook

📊 Polymarket Prediction Market Analysis

On-demand AI analysis for prediction markets. Input a Polymarket link or market title → AI analyzes probability divergence, opportunity score, and provides trading recommendations.

Features:

  • 🔍 Smart Search — Supports market links, slugs, or natural language titles
  • 🤖 AI Probability Prediction — Compares AI-predicted probability vs market probability
  • 📈 Opportunity Scoring — Calculates opportunity score based on divergence and confidence
  • 💡 Trading Recommendations — YES/NO/HOLD with detailed reasoning and key factors
  • 📚 History Tracking — View all your past analyses with full details in a dedicated history tab
  • 💰 Billing Integration — Configurable credit consumption per analysis (set via BILLING_COST_POLYMARKET_DEEP_ANALYSIS)
  • 🌍 Multi-Language — AI responses match your frontend language (English/Chinese)
  • 📊 Admin Statistics — All analyses tracked in user management dashboard

Usage:

1. Navigate to AI Asset Analysis → Prediction Markets tab
2. Input Polymarket link or market title
3. AI analyzes and returns:
   - Market probability vs AI-predicted probability
   - Divergence analysis
   - Opportunity score (0-100)
   - Trading recommendation (YES/NO/HOLD)
   - Detailed reasoning and key factors
4. View analysis history anytime

💰 Built-in Monetization

Most open-source projects need months of custom billing work. QuantDinger ships with a complete monetization system out of the box:

  • 💳 Membership Plans — Monthly / Yearly / Lifetime tiers with configurable pricing & credits
  • ₿ USDT On-Chain Payment — TRC20 scan-to-pay, HD Wallet (xpub) per-order addresses, auto-reconciliation via TronGrid
  • 🏪 Indicator Marketplace — Users publish & sell Python indicators, you take commission
  • ⚙️ Admin Dashboard — Order management, AI usage stats, user analytics

🔐 Enterprise-Grade Security

  • Multi-User — PostgreSQL-backed accounts with role-based permissions
  • OAuth — Google & GitHub one-click login
  • Protection — Cloudflare Turnstile, IP/account rate limiting, email verification
  • Demo Mode — Read-only mode for public showcases
🧠 AI Agent Architecture Diagram (Click to expand)
flowchart TB
    subgraph Entry["🌐 API Entry"]
        A["📡 POST /api/analysis/multi"]
        A2["🔄 POST /api/analysis/reflect"]
    end
    subgraph Service["⚙️ Service Orchestration"]
        B[AnalysisService]
        C[AgentCoordinator]
        D["📊 Build Context<br/>price · kline · news · indicators"]
    end
    subgraph Agents["🤖 7-Agent Workflow"]
        subgraph P1["📈 Phase 1 · Parallel Analysis"]
            E1["🔍 MarketAnalyst"]
            E2["📑 FundamentalAnalyst"]
            E3["📰 NewsAnalyst"]
            E4["💭 SentimentAnalyst"]
            E5["⚠️ RiskAnalyst"]
        end
        subgraph P2["🎯 Phase 2 · Bull vs Bear Debate"]
            F1["🐂 BullResearcher"]
            F2["🐻 BearResearcher"]
        end
        subgraph P3["💹 Phase 3 · Final Decision"]
            G["🎰 TraderAgent → BUY / SELL / HOLD"]
        end
    end
    subgraph Memory["🧠 Local Memory Store"]
        M1[("Agent Memories (PostgreSQL)")]
    end
    subgraph Reflect["🔄 Reflection Loop"]
        R[ReflectionService]
        W["⏰ ReflectionWorker → verify + learn"]
    end
    A --> B --> C --> D
    D --> P1 --> P2 --> P3
    Agents <-.->|"RAG retrieval"| M1
    C --> R
    W -.->|"update memories"| M1
Loading

🔌 Supported Exchanges & Brokers

Cryptocurrency (Direct API Trading)

Exchange Markets
Binance Spot, Futures, Margin
OKX Spot, Perpetual, Options
Bitget Spot, Futures, Copy Trading
Bybit Spot, Linear Futures
Coinbase Spot
Kraken Spot, Futures
KuCoin Spot, Futures
Gate.io Spot, Futures
Bitfinex Spot, Derivatives

Traditional Brokers & Markets

Market Broker/Source Trading
US Stocks Interactive Brokers (IBKR), Yahoo Finance, Finnhub ✅ Via IBKR
Forex MetaTrader 5 (MT5), OANDA ✅ Via MT5
Futures Exchange APIs ⚡ Data + Notify

🏗️ Architecture & Configuration

Tech Stack

Layer Technology
AI Engine 7-Agent Multi-Agent System · RAG Memory · 5+ LLM Providers · Vibe Coding (NL→Python)
Backend Python 3.10+ · Flask · PostgreSQL 16 · Redis (optional)
Frontend Vue.js · Ant Design · KlineCharts · ECharts
Payment USDT TRC20 On-Chain · HD Wallet (BIP-32/44) · TronGrid API
Mobile Vue 3 + Capacitor (Android / iOS)
Deploy Docker Compose · Nginx · Zero-build one-click
┌─────────────────────────────────────┐
│         Docker Compose              │
│                                     │
│  ┌───────────────────────────────┐  │
│  │  frontend (Nginx)  → :8888   │  │
│  └──────────────┬────────────────┘  │
│                 │ /api/* proxy       │
│  ┌──────────────▼────────────────┐  │
│  │  backend (Flask)   → :5000   │  │
│  └──────────────┬────────────────┘  │
│  ┌──────────────▼────────────────┐  │
│  │  postgres (PG 16)  → :5432   │  │
│  └───────────────────────────────┘  │
│                                     │
│  External: LLM APIs · Exchanges ·   │
│  TronGrid · Data providers          │
└─────────────────────────────────────┘

Repository Layout

QuantDinger/
├── backend_api_python/          # 🐍 Backend (Open Source, Apache 2.0)
│   ├── app/routes/              #   API endpoints
│   ├── app/services/            #   Business logic (AI, trading, payment)
│   ├── migrations/init.sql      #   Database schema
│   ├── env.example              #   ⚙️ Config template → copy to .env
│   └── Dockerfile
├── frontend/                    # 🎨 Frontend (Pre-built)
│   ├── dist/                    #   Static files (HTML/JS/CSS)
│   ├── Dockerfile               #   Nginx image
│   └── nginx.conf               #   SPA routing + API proxy
├── docs/                        # 📚 Guides & tutorials
├── docker-compose.yml           # 🐳 One-click deployment
└── LICENSE                      # Apache 2.0
⚙️ Configuration Reference (.env)

Use backend_api_python/env.example as template:

Category Key Variables
Auth SECRET_KEY, ADMIN_USER, ADMIN_PASSWORD
Database DATABASE_URL (PostgreSQL connection string)
AI / LLM LLM_PROVIDER, OPENROUTER_API_KEY, OPENAI_API_KEY
OAuth GOOGLE_CLIENT_ID, GITHUB_CLIENT_ID
Security TURNSTILE_SITE_KEY, ENABLE_REGISTRATION
Membership MEMBERSHIP_MONTHLY_PRICE_USD, MEMBERSHIP_MONTHLY_CREDITS
USDT Payment USDT_PAY_ENABLED, USDT_TRC20_XPUB, TRONGRID_API_KEY
Proxy PROXY_PORT or PROXY_URL
Workers ENABLE_PENDING_ORDER_WORKER, ENABLE_PORTFOLIO_MONITOR
🔌 API Endpoints
Endpoint Description
GET /api/health Health check
POST /api/user/login User authentication
GET /api/user/info Current user info
GET /api/billing/plans Membership plans
POST /api/billing/usdt/create-order Create USDT payment order

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


📚 Documentation Index

All detailed guides are in the docs/ folder:

Getting Started

Document Description
Changelog Version history & migration notes
Multi-User Setup PostgreSQL multi-user deployment

Strategy Development

Guide 🇺🇸 EN 🇨🇳 CN 🇹🇼 TW 🇯🇵 JA 🇰🇷 KO
Strategy Dev EN CN TW JA KO
Cross-Sectional EN CN
Code Examples examples/

Broker & Integration

Guide English 中文
IBKR (US Stocks) Guide —
MT5 (Forex) Guide 指南
OAuth (Google/GitHub) Guide 指南

Notifications

Channel English 中文
Telegram Setup 配置
Email (SMTP) Setup 配置
SMS (Twilio) Setup 配置

💼 License & Commercial

Open Source License

Backend source code is licensed under Apache License 2.0. See LICENSE.

The frontend UI is provided as pre-built files. Trademark rights (name/logo/branding) are governed separately — see TRADEMARKS.md.

🎓 Free Source Code for Non-Profit & Education

If you are a university, research institution, non-profit, community group, or educational program, you can apply for free authorization and full frontend source code:

  • 🏫 Universities & academic research
  • 🌍 Open-source communities & developer groups
  • 🤝 Non-profit & public welfare organizations
  • 📚 Educational programs & student hackathons

💼 Commercial License

For commercial use, purchase a license to get:

  • Full frontend source code + future updates
  • Branding authorization — modify name/logo/copyright as agreed
  • Operations support — deployment, upgrades, incident response
  • Consulting — architecture review, performance tuning

📬 Contact

Channel Link
Telegram t.me/worldinbroker
Email [email protected]

🤝 Community & Support

Telegram Discord YouTube

  • Contributing Guide · Contributors
  • Report Bugs / Request Features
  • Email: [email protected]

💝 Support the Project

Crypto Donations (ERC-20 / BEP-20 / Polygon / Arbitrum)

0x96fa4962181bea077f8c7240efe46afbe73641a7

USDT ETH


🎓 Supporting Partners

Indiana University QFS

Quantitative Finance Society (QFS)
Indiana University Bloomington

💡 Want to become a partner? Contact [email protected] or Telegram.


Acknowledgements

Built with ❤️ on the shoulders of: Flask · Pandas · CCXT · yfinance · Vue.js · Ant Design Vue · KlineCharts · ECharts · Capacitor · bip-utils

If QuantDinger helps you, consider ⭐ starring the repo — it means a lot!

Tech Stack

GoPythonDockerVueFlaskPostgreSQLRedisLLMNginxOpenAIGPTCloudflare
Open Live ProjectAudit Repo

Reviews0

Log in to write a review.

ActiveLast commit today
bug_report2open issues
Submitted March 21, 2026

auto_awesomeYour strongest next moves after QuantDinger