Developer API

Read-only probability, signal, and track-record data.

The Forecast Alpha API is a research interface: versioned JSON endpoints for market probabilities, signal states, and public proof data. It never places orders.

Calibrated-signals pilot OpenAPI JSON API keys

API surface

Versioned under /api/v1

GET

signals

/api/v1/signals

GET

market detail

/api/v1/markets/:id

GET

B2B pilot

/api/v1/data-products/…

Authentication

Keys, limits, and response metadata

- Bearer key: Authorization: Bearer fa_... - shown once at creation, stored as SHA-256.
- Rate limit: 60 requests/minute per key. Keyless public endpoints are IP-limited.
- Every response includes meta: model version, generated time, disclaimer, and simulated fields.

Machine-readable spec: /api/v1/openapi.json.

Endpoints

Read-only research routes

GET/api/v1/signalsbearer key

Active signals across all markets, sorted by edge. Filters: category, signal (LONG_YES | LONG_NO | WATCH | NO_TRADE), and minEdge.

GET/api/v1/markets/:idbearer key

Full market detail: latest prediction, input snapshot, latest signal, and resolution-analysis summary.

GET/api/v1/track-recordno key - IP rate-limited

The public track record: headline Brier and beat-rate, plus paginated predictions. Use ?tab=live|simulated&page=1.

GET/api/v1/data-products/calibrated-signalsread:data-products

Governed design-partner feed with point-in-time timestamps, model and market probabilities, confidence intervals, evidence provenance, freshness, liquidity, risk, historical cohort results, revisions, explicit commercial-readiness blockers, and measured pilot SLA results across the full active non-demo market population. The current pilot target is 100% complete signals no older than six hours. Deliveries are durably audited and remain research-only until every launch gate passes. See the calibrated-signals contract and methodology.

Example

Request and response

curl -H "Authorization: Bearer fa_..." \
  "https://your-deployment.vercel.app/api/v1/signals?category=FED&minEdge=0.05"

{
  "data": [
    {
      "marketId": "market_123",
      "title": "Fed cuts rates at the July 2026 FOMC meeting?",
      "category": "FED",
      "platform": "DEMO",
      "impliedProbability": 0.41,
      "modelProbability": 0.34,
      "edgeEv": 0.036,
      "signal": "WATCH",
      "side": "NO",
      "riskScore": 12,
      "confidence": 0.89,
      "noTradeReasons": [],
      "modelVersion": "2.0.0",
      "generatedAt": "2026-06-12T14:00:00.000Z"
    }
  ],
  "meta": {
    "modelVersion": "2.0.0",
    "generatedAt": "2026-06-12T14:00:05.000Z",
    "disclaimer": "Research only. Not financial advice.",
    "simulatedFields": ["modelProbability", "edgeEv", "signal", "riskScore", "confidence"]
  }
}

API positioning

The API exposes research data only. It is not an order-routing API, a trading bot interface, or a guarantee that any signal is suitable for a real-money trade.

Forecast Alpha is a research and analytics tool, not financial advice. Model probabilities, signals, confidence, and risk scores are research outputs. Paper and shadow portfolio fields are simulated; connecting credentials does not grant order authority. Live order submission is disabled by platform policy. Fields listed in meta.simulatedFields are modeled/simulated values.

API keys are managed under Settings API.

Preparing this view

Retrieving the current information and preserving your place. No action is required.

{ "data": [ { "marketId": "market_123", "title": "Fed cuts rates at the July 2026 FOMC meeting?", "category": "FED", "platform": "DEMO", "impliedProbability": 0.41, "modelProbability": 0.34, "edgeEv": 0.036, "signal": "WATCH", "side": "NO", "riskScore": 12, "confidence": 0.89, "noTradeReasons": [], "modelVersion": "2.0.0", "generatedAt": "2026-06-12T14:00:00.000Z" } ], "meta": { "modelVersion": "2.0.0", "generatedAt": "2026-06-12T14:00:05.000Z", "disclaimer": "Research only. Not financial advice.", "simulatedFields": ["modelProbability", "edgeEv", "signal", "riskScore", "confidence"] } }