Architecture
How STOCK FOMO works.
A transparent look at the event-driven, multi-provider system behind your market data and emails.
Gemini with MiniMax fallbackOpen source · AGPL-3.0
Market data
Two data modes, one cache.
Charts always stream from TradingView. Everything we price ourselves goes through a shared cache with timeouts, so a slow provider never stalls a page.
Cached
HourlyDefault for the public site. Quotes are fetched once an hour and shared by every user, so cost grows with symbols, not people.
Realtime
Every 15 secondsFor a realtime deployment. Set NEXT_PUBLIC_OPENSTOCK_DATA_MODE=realtime and on-screen prices refresh live and email price alerts turn on.
| Market | Charts | Our quotes and alerts |
|---|---|---|
| US stocks, crypto | Live | Yes |
| Forex | Live | No |
| Canada, Australia | Delayed | No |
| India (BSE), Germany | End of day | No |
AI
Emails that don’t go down with a provider.
Welcome emails and news summaries are written by Gemini 2.5 Flash-Lite. If it fails, the request is retried on MiniMax-M3, or any OpenAI-compatible provider you configure.
- 1A user signs up, or a cron fires
- 2Inngest runs the function
- 3Gemini writes the text
- 4MiniMax takes over if Gemini fails
- 5The email goes out
Background jobs
Four jobs keep things moving.
Welcome email
An AI-written intro tailored to the country, goal, risk and industry picked at sign-up.
On sign-up
Weekly news
Summarises the week’s market news and sends it as a Kit broadcast.
Mon 09:00
Price alerts
Checks every active alert against Finnhub quotes and emails the owner when one fires. Realtime mode only.
Every 5 min
Re-engagement
Finds dormant accounts and sends a gentle nudge.
Daily 10:00
Stack
Built on services you can inspect.
FinnhubQuotes, company profiles, search and news. A pool of keys, rotated per request.TradingViewCharts, heatmaps, technicals and market widgets, embedded live.InngestBackground jobs and schedules, with retries.Better AuthEmail, Google and GitHub sign-in with MongoDB sessions.MongoDB AtlasUsers, watchlists and alerts.KitNewsletter broadcasts for the weekly digest.