Social Forex

---

SocialForex is a full-stack trading companion for retail forex / gold / crypto traders. It combines live market data, a community signal room, MT5 copy-trading, a deep trading journal with AI reviews, and an academy for beginners — in Vietnamese and English.

⚠️ Everything in this project is for education and information only. It is not investment advice. Trading leveraged products carries a high risk of losing money.

Features

📈 Market data

Live quotes — forex, metals, energy and crypto, auto-refreshing	TradingView chart with watchlist and AI expert analysis
Market screener — M15/H1/H4/D1 ratings, RSI, ADX per pair	Currency-strength heatmap across 8 majors
Economic calendar — VN/UTC time, impact filters, AI explanation	Live desk — chart + news risk + lot sizing before every trade

📡 Signals & community

Signal room — free and VIP signals, MT5-verified, comments & votes	Confident technical signals — 4H Strong confirmed by H1 + M15, accuracy tracked per source (TradingView, CFTC COT, OANDA, Myfxbook, IG)
Leaderboard — win rate, profit factor, XP; follow or copy	Community sentiment — long/short ratio from active signals
MT5 copy-trading — Expert Advisor with fixed-lot / %-risk sizing	MT5 positions — live P/L, auto-close before weekend / end of day / at breakeven, AI portfolio review

📒 Trading journal & discipline

Trading journal — auto-synced from MT5, win rate, payoff, expectancy	Advanced stats — discipline scorecard, tilt days, mistake tags, MAE/MFE, weekly & daily AI reviews
Daily trading plan — pre-trade checklist, risk limits, streaks	AI Auto-Scalp — multi-symbol scalping analysis with quality thresholds
Price alerts with web push notifications	Dashboard — daily activity, XP level, referral program

🎓 Learning

Academy / Wiki — price action path from beginner to advanced	AI forex articles — daily analysis enriched with web search and chart snapshots
Beginner mission board — 16 auto-verified tasks with XP	Calculators — position size, pivot points, margin
Backtest — Monte Carlo equity simulation	Dark mode & mobile-first

Screenshots are regenerated with node scripts/screenshots.mjs (account balances are blurred automatically).

🤖 Use it from your AI assistant (MCP)

SocialForex is also a public MCP server — quotes, economic calendar, screener, currency strength, trading sessions and a position-size calculator, right inside Claude, Cursor, VS Code or DeepSeek Harness:

claude mcp add --transport http socialforex https://toolforex.xyz/api/mcp

See docs/mcp.md for the tool list and other clients.

Tech stack

• Next.js 16 (App Router) + React 19, Tailwind CSS v4 + shadcn/ui
• Prisma 7 + PostgreSQL
• NextAuth v5 (credentials, JWT sessions)
• next-intl v4 — Vietnamese (default) and English
• AI providers: DeepSeek, Groq, OpenAI or Anthropic (configurable in the admin panel)
• MetaTrader 5 Expert Advisors for copy-trading and position bridging (docs/mt5)
• Vitest unit tests, Playwright end-to-end tests

Getting started

Requirements: Node.js 20+, Docker (for PostgreSQL).

git clone https://github.com/namlxuit056/social-forex.git
cd social-forex
npm install
cp .env.example .env          # then fill in DATABASE_URL and AUTH_SECRET
npm run docker:up             # start PostgreSQL
npm run db:deploy             # apply migrations
npm run db:seed               # optional sample data
npm run dev                   # http://localhost:3000

Only DATABASE_URL, AUTH_SECRET and NEXTAUTH_URL are required. Every other key in .env.example (AI providers, Telegram, PayPal, OANDA, Myfxbook, Vercel Blob…) turns on an optional feature.

Useful commands:

npm run lint      # ESLint
npm test          # Vitest
npm run build     # production build

Self-hosting on your own machine with pm2 + Cloudflare Tunnel is documented in docs/self-hosting.md.

Contributing

Issues and pull requests are welcome — see CONTRIBUTING.md. Please report security problems privately as described in SECURITY.md.

Support the project

SocialForex is built and run by one developer and hosted at toolforex.xyz. If it helps your trading, you can support hosting, data and AI costs:

• ☕ Support with PayPal or card — one-off, any amount from $1
• ❤️ Sponsor on GitHub — monthly
• ⭐ Star this repository and share toolforex.xyz with other traders
• 💬 Join the Telegram group: t.me/toolforex

License

GNU AGPL-3.0. You may use, modify and self-host this project; if you run a modified version as a public service, you must publish your source code under the same license.

---

Tiếng Việt

SocialForex là nền tảng mã nguồn mở hỗ trợ trader forex / vàng / crypto: giá realtime, phòng tín hiệu cộng đồng, copy-trade MT5, nhật ký giao dịch có AI chấm điểm kỷ luật, lịch kinh tế, screener, heatmap và học viện cho người mới.

• 🌐 Dùng thử ngay: toolforex.xyz
• 🛠️ Tự cài đặt: xem mục Getting started
• ❤️ Ủng hộ dự án: PayPal / thẻ tại toolforex.xyz/support hoặc GitHub Sponsors — giúp trang trải chi phí server, dữ liệu và AI
• 💬 Nhóm Telegram: t.me/toolforex
• 🤖 Dùng trong AI assistant (Claude, Cursor, DeepSeek Harness…) qua MCP: https://toolforex.xyz/api/mcp — xem docs/mcp.md

Mọi nội dung chỉ mang tính giáo dục, không phải lời khuyên đầu tư.