Skip to main content
Mindforge LogoMINDFORGE INTELLIGENCE
Mindforge Intelligence

60-Day Pilot Guide

Complete guide to your Market Risk Classifier pilot: signup, daily classifications, API access, and upgrade options.

1. What's Included

Your 60-day institutional pilot provides everything needed to evaluate the Market Risk Classifier against your internal risk workflows.

ItemDetails
Daily ClassificationsPre-market email every U.S. trading day with the current risk shape classification.
5-Year Historical DataDaily classifications from 2020-01-01 through T-30 days, for backtesting and validation.
API AccessProgrammatic access at 500 requests per hour for integration testing and data retrieval.
Validation PacketBacktesting 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 shape 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 shape classification for the trading day.
  • Risk shape definition and meaning, so the classification is self-contained.
  • Historical precision metrics for the active risk shape.
  • Research context and institutional use cases relevant to the classification.

3.2 Troubleshooting: "I Did Not Get Today's Alert"

  1. 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.
  2. Check your spam folder. The sender is alerts@mindforge.tech. Mark as "Not spam" and add the sender to your contacts.
  3. Allowlist the sender. Ask your IT team to allowlist @mindforge.tech in your mail gateway. Corporate filters are the most common cause.
  4. Verify live status. Visit mindforge.tech/market-risk-classifier-status to confirm the system published a classification today.
  5. 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

ParameterPilot Tier
API rate limit500 requests per hour
Historical data range2020-01-01 through T-30 days
Pilot duration60 days from activation
SupportEmail 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 shape, 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.
Documentation HubRisk Shapes Reference

Research use only. Not investment advice. Past performance ≠ future results. Mindforge is not a registered investment adviser. Full terms · Methods

Market State Classification | Mindforge