WallstreetHustler / APEX V4 Squeeze Scanner
An educational options-candidate research system. The production application is
APEX V4 on Render; the repository also retains the larger research dashboard,
Thinkorswim scripts, validators, and evidence archive so the audit trail is not lost.
Production architecture
| Component | Location | Purpose |
|---|
| Production web app/API | apex-v4/ | Canonical Render service and multi-factor scanner |
| Research dashboard | repository root | Broader experimental interface; not the production entry point |
| Thinkorswim package | evidence/thinkorswim/ and FINAL_V4/ | Install candidates, reference scripts, and audit evidence |
| Deployment definition | render.yaml | Single authoritative hosting configuration |
Production: wallstreethustler.com
Render health check: https://wallstreethustler.com/api/health
The beginner view includes daily candlestick charts, volume, support and resistance,
plain-English pattern lessons, an educational study zone, and a safety/invalidation
line. These are learning aids, not guaranteed entries or personalized trade advice.
Run the production application locally
cd apex-v4
npm ci
npm start
Open http://localhost:3000. Verify the backend at
http://localhost:3000/api/health; it should return ok: true and identify
service: "apex-v4".
A missing data key does not crash the server, but scans fail visibly rather than
fabricating an empty result. Environment variables are explained in
apex-v4/.env.example and docs/DATA_SETUP.md.
Deploy on Render
Use the included root render.yaml Blueprint; it points Render at apex-v4
automatically. For a manually created Web Service, set Root Directory to
apex-v4. Render supplies PORT automatically. Follow
docs/RENDER_DEPLOY.md. Vercel deployment files were removed
after the production domain was migrated; Vercel remains only the domain registrar
and DNS provider.
Important scope
- The daily-bar engine ranks the underlying stock. It does not select or validate an option contract.
- Price and volume can label a generic squeeze/flush proxy. A gamma-flush label requires recent ask-side put flow, short-gamma GEX, and falling price from the optional licensed feed; candles alone never claim gamma positioning.
- When qualifying flow agrees with direction, the beginner view repeats the observed call or put strike as a research reference and converts the user's loss limit into a maximum premium/ask ceiling. It still lacks live option bid/ask, delta, IV, volume, and open-interest validation.
- Selling puts is shown only as a cash-secured or defined-risk lesson around chart support. The app does not submit short-option orders or approve naked short puts.
- Every surfaced stock must be at least $10 with at least $25M estimated average daily dollar volume.
- A live stock spread at or below 0.25% is marked
TIGHT; missing quotes are marked CHECK, never assumed liquid.
- An options-flow row is shown only when the optional licensed feed supplies it.
- A score is a technical ranking, not a probability of profit or a win rate.
- No component places orders or connects to Robinhood. The Robinhood MCP is intentionally excluded.
- Public status is beta / paper-trading only. Historical confidence intervals in the current evidence package include zero, so profitability is not demonstrated.
See docs/OPTIONS_TRADING_SCOPE.md and docs/RELEASE_STATUS.md before testing or publishing.
Local checks
npm test
npm run check:release
Market-data configuration
The browser never receives a provider key. Configure server-side bars and quote providers in the hosting environment as described in docs/DATA_SETUP.md. If none is configured, /api/bars or /api/quotes fails visibly; the interface must not describe missing data as “no qualifying setups.”
The V4 table also replays historical daily bars to audit objective three-session squeeze/flush moves. Those labels measure price and volume, not proof of short covering, and they do not include historical NBBO spreads.
Thinkorswim evidence package
The audited package is stored under evidence/thinkorswim/. Only files inside its install_current directory are install candidates. Experimental and reference-only files are not presented as live-verified.
