GET

/api/auth/forecast-requests/{jobId}

Read an owned forecast request

Auth x-quotient-api-key or x402

Parameters

Name	In	Type	Description
jobId	path, required	string

Response fields

Field	Type	Meaning
jobId	string
status	"accepted" \| "submitted" \| "running" \| "succeeded" \| "rejected" \| "failed"
createdAt	string
updatedAt	string
forecastIds	string[]
forecasts	ForecastRequestForecast[]	Published forecast outputs. Empty while pending or when execution fails.
errorCode	string
listing	CanonicalMarketRouting

Billing and limits

Calls are billed to prepaid credits, or per call over x402. The price above is the reference price; the 402 challenge returned at request time is what a call actually costs.

One request may be in flight at a time, and request starts must be at least one second apart. A rejected 429 is not billed. See rate limits.

curl

curl -H "x-quotient-api-key: qt_…" \
  "https://quotient-api-gateway.onrender.com/api/auth/forecast-requests/<jobId>"

200 · application/json

{
  "jobId": "…",
  "status": "accepted",
  "createdAt": "…",
  "updatedAt": "…",
  "forecastIds": [
    "…"
  ],
  "forecasts": [
    {
      "id": "…",
      "question": "…",
      "probability": 0,
      "createdAt": "…",
      "headline": "…",
      "bluf": "…",
      "thesis": "…",
      "reasoningSummary": "…",
      "citationCount": 0,
      "relationships": {
        "assets": [
          {}
        ],
        "markets": [
          {}
        ],
        "signals": [
          {}
        ],
        "truncated": {
          "assets": false,
          "markets": false,
          "signals": false
        }
      }
    }
  ],
  "errorCode": "…",
  "listing": {
    "venue": "polymarket",
    "nativeMarketId": "…",
    "nativeEventId": "…",
    "seriesTicker": "…",
    "marketKey": "…",
    "slug": "…",
    "marketUrl": "…",
    "sourceUrl": "…"
  }
}