nofx/.github/ISSUE_TEMPLATE/bug_report.md

name, about, title, labels, assignees

name	about	title	labels	assignees
Bug Report	Report a bug to help us improve NOFX	[BUG]	bug

⚠️ Before submitting: Please check the Troubleshooting Guide (中文版) to see if your issue can be resolved quickly.

🐛 Bug Description

🔍 Bug Category

• Trading execution (orders not executing, wrong position size, etc.)
• AI decision issues (unexpected decisions, only opening one direction, etc.)
• Exchange connection (API errors, authentication failures, etc.)
• UI/Frontend (display issues, buttons not working, data not updating, etc.)
• Backend/API (server errors, crashes, performance issues, etc.)
• Configuration (settings not saving, database errors, etc.)
• Other: _________________

📋 Steps to Reproduce

1. Go to '...'
2. Click on '...' / Run command '...'
3. Configure '...'
4. See error

✅ Expected Behavior

❌ Actual Behavior

📸 Screenshots & Logs

Frontend Error (if applicable)

Browser Console Screenshot:

Network Tab (failed requests):

Backend Logs (if applicable)

Docker users:

# View backend logs
docker compose logs backend --tail=100

# OR continuously follow logs
docker compose logs -f backend

Manual/PM2 users:

# Terminal output where you ran: ./nofx
# OR PM2 logs:
pm2 logs nofx --lines 100

Backend Log Output:

Paste backend logs here (last 50-100 lines around the error)

Trading/Decision Logs (if trading issue)

Decision Log Path: decision_logs/{trader_id}/{timestamp}.json

{
  "paste relevant decision log here if applicable"
}

💻 Environment

System:

• OS: [e.g. macOS 13, Ubuntu 22.04, Windows 11]
• Deployment: [Docker / Manual / PM2]

Backend:

• Go Version: [run: go version]
• NOFX Version: [run: git log -1 --oneline or check release tag]

Frontend:

• Browser: [e.g. Chrome 120, Firefox 121, Safari 17]
• Node.js Version: [run: node -v]

Trading Setup:

• Exchange: [Binance / Hyperliquid / Aster]
• Account Type: [Main Account / Subaccount]
• Position Mode: [Hedge Mode (Dual) / One-way Mode] ← Important for trading bugs!
• AI Model: [DeepSeek / Qwen / Custom]
• Number of Traders: [e.g. 1, 2, etc.]

🔧 Configuration (if relevant)

Leverage Settings:

{
  "btc_eth_leverage": 5,
  "altcoin_leverage": 5
}

Any custom settings:

📊 Additional Context

Frequency:

• Happens every time
• Happens randomly
• Happened once

Timeline:

• Did this work before? [ ] Yes [ ] No
• When did it break? [e.g. after upgrade to v3.0.0, after changing config, etc.]
• Recent changes? [e.g. updated dependencies, changed exchange, etc.]

Impact:

• System cannot start
• Trading stopped/broken
• UI broken but trading works
• Minor visual issue
• Other: _________________

💡 Possible Solution

---

📝 Quick Tips for Faster Resolution

For Trading Issues:

1. ✅ Check Binance position mode: Go to Futures → ⚙️ Preferences → Position Mode → Must be Hedge Mode
2. ✅ Verify API permissions: Futures trading must be enabled
3. ✅ Check decision logs in decision_logs/{trader_id}/ for AI reasoning

For Connection Issues: 4. ✅ Test API connectivity: curl http://localhost:8080/api/health 5. ✅ Check API rate limits on exchange 6. ✅ Verify API keys are not expired

For UI Issues: 7. ✅ Hard refresh: Ctrl+Shift+R (or Cmd+Shift+R on Mac) 8. ✅ Check browser console (F12) for errors 9. ✅ Verify backend is running: docker compose ps or ps aux | grep nofx