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.

OpenAPI JSON API keys

API surface

Versioned under /api/v1

GET

signals

/api/v1/signals

GET

market detail

/api/v1/markets/:id

GET

track record

/api/v1/track-record

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.

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. All values are research signals on simulated/paper terms; no real-money execution exists. Model probabilities, signals, confidence and risk scores are simulated and labeled via meta.simulatedFields.

API keys are managed under Settings API.