1. What's Included
Your 60-day institutional pilot provides everything needed to evaluate the Market Risk Classifier against your internal risk workflows.
| Item | Details |
|---|
| Daily Classifications | Pre-market email every U.S. trading day with the current risk state classification. |
| 5-Year Historical Data | Daily classifications from 2020-01-01 through T-30 days, for backtesting and validation. |
| API Access | Programmatic access at 500 requests per hour for integration testing and data retrieval. |
| Validation Packet | Backtesting methodology, walk-forward folds, and performance metrics documentation. |
All items are active from the day your pilot begins.
2. Sign Up
Request pilot access by providing your professional details. Your API key will be generated and emailed within minutes of approval.
2.1 Required Information
Name
Your full name for account personalization.
Email
Professional email address for API key delivery and daily classifications.
Institution
Your organization or fund name.
Role
Your job title (e.g., Portfolio Manager, CRO, Quant Researcher).
Instant activation. Your API key will be emailed within minutes. Check your spam folder if you do not see it, and add alerts@mindforge.tech to your contacts.
3. Daily Classifications
Every U.S. trading day, you receive a pre-market email with the current risk state classification, its definition, historical precision metrics, and research context.
Delivery
By 07:30 ET (pre-market)
Frequency
U.S. trading days only
Sender
alerts@mindforge.tech
3.1 What Each Email Contains
- Current risk state classification for the trading day.
- Risk state definition and meaning, so the classification is self-contained.
- Historical precision metrics for the active risk state.
- Research context and institutional use cases relevant to the classification.
3.2 Troubleshooting: "I Did Not Get Today's Alert"
- Check the time. Alerts go out by 07:30 ET on U.S. trading days. If it is before 07:30 ET, the alert may not have been sent yet. Weekends and U.S. market holidays do not 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 mindforge.tech/market-risk-classifier-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. The team can re-send and trace delivery.
4. API Integration
Use the API to programmatically access current classifications and historical data for backtesting and integration testing.
4.1 Endpoint Example
API EndpointGET https://api.mindforge.tech/api/msd/v1/state/today
Authorization: Bearer <YOUR_JWT_TOKEN>
4.2 Rate Limits and Data Access
| Parameter | Pilot Tier |
|---|
| API rate limit | 500 requests per hour |
| Historical data range | 2020-01-01 through T-30 days |
| Pilot duration | 60 days from activation |
| Support | Email support included |
4.3 Troubleshooting: API Errors
- 401 Unauthorized: the token is missing, malformed, or expired. The header must be exactly
Authorization: Bearer YOUR_JWT_TOKEN with no quotes around the token and no leading or trailing whitespace. Check the welcome email for the active key. - 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 the Professional license. Webhook endpoints are not enabled by default. Request access via support@mindforge.tech.
- 429 Too Many Requests: you have hit the 500 requests per hour pilot limit. The response includes a
Retry-After header indicating when to retry. - Still stuck? Email support@mindforge.tech with the request URL, response status, and (redacted) token prefix.
4.4 Historical Data and Backtest Exports
Three ways to retrieve historical classifications, depending on your workflow.
- Per-date API.
GET /api/msd/v1/state/{date} returns a single classification. Iterate over dates to build a time series. Pilot tier: 2020-01-01 through T-30. - Bulk CSV export. Email research@mindforge.tech with your registered email and date range. The team will send the daily classifications CSV with risk state, manifest version, and rule provenance.
- Validation packet. Backtest manifests, walk-forward folds, and the episode ledger are bundled in the institutional validation packet. See the research briefs.
5. Upgrade to Professional License
If validated, upgrade before your 60-day pilot expires to maintain uninterrupted access to daily classifications and expanded historical data.
5.1 Professional License Includes
- Daily pre-market classifications (indefinite, no expiration).
- Full 12-year historical access (2012 through 2024).
- 2,000 API requests per hour (4x the pilot limit).
- Priority email support with faster response times.
- Quarterly validation updates with refreshed manifests and metrics.
Market Risk Classifier and related services are for research and informational purposes only. Not investment, financial, or trading advice. Past performance does not guarantee future results. Mindforge is not a registered investment adviser. See full terms at
mindforge.tech/terms.
