MINDFORGE • MARKET STATE DETECTOR
60-Day Institutional Pilot Guide
Complete guide to your Market State Detector pilot. Signup through daily alerts, API access, and upgrade options.
⚖️ Research and Educational Use Only
Market State Detector is for research, backtesting, and methodology validation purposes only. Classifications describe past market conditions and are NOT predictions, forecasts, or investment recommendations. Past performance does not guarantee future results.
Your Pilot Journey
Sign Up
Receive API key instantly
Daily Emails
Pre-market classifications
Validate
Test with historical data
Upgrade
Go live if validated
What's Included in Your 60-Day Pilot
Daily Pre-Market Classifications
Email alerts delivered pre-market every U.S. trading day with current market state
5 Years of Historical Data
Daily classifications from 2020-01-01 to T-30 days for backtesting
API Access
500 requests/hour for programmatic access and integration testing
Complete Validation Packet
Backtesting methodology and performance metrics
Sign Up for Pilot Access
Request your pilot access by providing your professional details. Your API key will be generated instantly and sent to your email.
Required Information
- •Name: Your full name for personalization
- •Email: Professional email (API key delivery and daily alerts)
- •Institution: Your organization or fund name
- •Role: Your job title (e.g., PM, CRO, Quant Researcher)
✓ Instant Activation: Your API key will be emailed within minutes. Check your spam folder if you don't see it.
Receive Daily Pre-Market Alerts
Every U.S. trading day, you'll receive a pre-market email with the current market state classification.
Email Timing
What's Included
I didn’t get today’s alert
- Check the time. Alerts go out by 07:30 ET on U.S. trading days. If it’s before 07:30 ET, the alert may not have been sent yet. Weekends and U.S. market holidays don’t receive alerts.
- Check your spam folder. The sender is alerts@mindforge.tech. Mark as “Not spam” and add the sender to your contacts.
- Allowlist the sender. Ask your IT team to allowlist @mindforge.tech in your mail gateway. Corporate filters are the most common cause.
- Verify live status. Visit /market-state-detector-status to confirm the system published a classification today.
- Still nothing by 08:00 ET? Email support@mindforge.tech with your registered email and the date. We can re-send and trace delivery.
API Integration & Backtesting
Use the API to programmatically access current classifications and historical data for backtesting.
API ENDPOINT EXAMPLE
GET https://api.mindforge.tech/api/msd/v1/state/todayAuthorization: Bearer <YOUR_JWT_TOKEN>
Rate Limits & Data Access
API Rate Limit
500 requests per hour
Historical Data
2020-01-01 to T-30 days
Pilot Duration
60 days from activation
Support
Email support included
My API call returned 401 or 403
- 401 Unauthorized — the token is missing, malformed, or expired.
- Header must be exactly:
Authorization: Bearer YOUR_JWT_TOKEN - No quotes around the token. No leading/trailing whitespace.
- Tokens are scoped to your pilot; check the welcome email for the active key.
- Header must be exactly:
- 403 Forbidden — the token is valid but the endpoint or date range is outside your tier.
- Pilot tier covers 2020-01-01 through T-30 days. Older or live (T+0) data requires Professional.
- Webhook endpoints are not enabled by default — request access via support@mindforge.tech.
- 429 Too Many Requests — you’ve hit the 500/hour pilot limit. The response includes a
Retry-Afterheader. - Still stuck? Email support@mindforge.tech with the request URL, response status, and (redacted) token prefix.
Historical data & backtest exports
Three ways to get historical classifications, depending on what you need.
- Per-date API.
GET /api/msd/v1/state/{date}returns a single classification. Iterate to build a series. Pilot tier: 2020-01-01 to T-30. - Bulk CSV export. Email research@mindforge.tech with your registered email and the date range. We send the daily_states CSV with state, manifest version, and rule provenance.
- Validation packet. Backtest manifests, walk-forward folds, and episode ledger are bundled in the institutional validation packet — see the research briefs.
Upgrade to Professional License
If validated, upgrade before your 60-day pilot expires to continue receiving daily classifications and access recent historical data.