Skip to main content
POST
Create an Asynchronous Multi-Model Quantura Forecast Job

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Replays the same normalized request without launching duplicate compute.

Maximum string length: 180

Body

application/json
prediction_length
integer
default:30
required
Required range: 1 <= x <= 512
horizon_mode
enum<string>
required
Available options:
trading_sessions,
calendar_days,
frequency_periods
quantiles
number[]
required
Required array length: 1 - 21 elements
models
object
required
source
object
required
transform
enum<string>
default:auto

Prediction-market sources enforce bounded logit forecasting, with epsilon 1e-6 at transform boundaries.

Available options:
auto,
log,
none,
logit
context_length
integer | null
default:512
Required range: 40 <= x <= 16384
model_failure_policy
enum<string>
default:fail
Available options:
fail,
renormalize
frequency
string
default:1D

Canonical market intervals: 1min, 5min, 15min, 30min, 1h, 4h, 1D, 1W-MON, 1MS. source.frequency determines market input bars; series/workspace datasets can also use validated pandas offsets.

calendar
string
default:NYSE
workspace_id
string
analytics_context
object

Optional consented website telemetry; sanitized separately from model configuration and excluded from cache identity. Invalid or unavailable telemetry does not block forecasting.

history_lag_minutes
integer
default:0

Input cutoff before request time, in minutes (hours × 60; days × 1440). Select up to 500 observations BEFORE cutoff. Source retention still applies. No fixed 90-day cutoff-age cap: 120 days is 172800 minutes; 180 days is 259200 minutes. Availability depends on provider retention. Positive values create a historical replay, not a previously published forecast. Later observations are separate overlays.

Required range: x >= 0
toto_variant
enum<string>
default:4m

Approved Toto size, smallest to largest. Only relevant when Toto is enabled. The server pins the checkpoint and revision, including in the cache identity; clients cannot submit arbitrary model repositories. All sizes require at least 32 observed values.

Available options:
4m,
22m,
313m,
1b,
2.5b
history_cutoff_at
string<date-time>

Optional past absolute cutoff with timezone offset (ISO 8601), subject to available source history. Cannot be combined with a positive history_lag_minutes. Browser calendar values convert from the user's device timezone to UTC.

prediction_end_at
string<date-time>

Optional absolute end date/time. After input materialization, the server derives the number of forecast bars only for completed future interval boundaries through this time (never rounded past the requested end), still subject to 512 and model-specific limits. NYSE daily forecasts use real exchange sessions in the selected calendar window. Overrides prediction_length.

analysis_mode
enum<string>
default:forecast

New jobs provide forecast quantiles without buy/sell classifications. Historical saved jobs remain readable.

Available options:
forecast

Response

Forecast job queued.

data
object
required
meta
object
required