Market Pulse
Personal stock prediction tracker for US and Korean markets.
What it does
- Ingests price data and news for ~30 US and KR tickers
- Runs bilingual sentiment analysis (FinBERT for EN and KO; VADER / keyword lexicon fallback)
- Trains a Random Forest model per horizon (1d / 7d / 30d) and produces directional predictions
- Serves everything through a React dashboard with bilingual UI and headline translation
Stack
| Layer |
Tech |
| Prices |
yfinance (US), FinanceDataReader (KR) |
| News |
Finnhub API (US), NAVER Finance scraper (KR) |
| Sentiment |
FinBERT (ProsusAI/finbert EN, snunlp/KR-FinBert-SC KO); VADER / keyword fallback |
| ML |
scikit-learn Random Forest |
| DB |
Supabase PostgreSQL (AWS ap-northeast-1) |
| API |
FastAPI on port 8000 |
| Frontend |
React 19 + TypeScript + Vite + Tailwind CSS on port 5173 |
Docs layout
- Architecture — product vision, end-to-end overview, agent architecture docs
- Spec — what each feature is and why it exists
- Implementation — how things are built, gotchas, how to extend (includes night agent)
- Plans — per-feature implementation plans and in-progress work
Links
Local dev
|
URL |
| Frontend |
http://localhost:5173 |
| Backend API |
http://localhost:8000 |
| API docs (Swagger) |
http://localhost:8000/docs |
GitHub
|
URL |
| Repository |
https://github.com/kosungjunmichael/FinTrack |
| Issues |
https://github.com/kosungjunmichael/FinTrack/issues |
| Project board |
https://github.com/users/kosungjunmichael/projects/1 |
| Pull requests |
https://github.com/kosungjunmichael/FinTrack/pulls |
Infrastructure
|
URL |
| Supabase dashboard |
https://supabase.com/dashboard/project/ufdhqjrwydihmrsabzvi |
| Supabase table editor |
https://supabase.com/dashboard/project/ufdhqjrwydihmrsabzvi/editor |
| Supabase logs |
https://supabase.com/dashboard/project/ufdhqjrwydihmrsabzvi/logs/postgres-logs |