Skip to main content
POST
/
strategies
/
{strategyId}
/
submit
Submit a LIVE or HISTORICAL run for a version of the strategy
curl --request POST \
  --url https://api.noonum.ai/v2/strategies/{strategyId}/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "as_of_date": "2023-12-25",
  "create_factsheet": false,
  "force": false,
  "priority": 5,
  "version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "completed": true,
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "exclusions": [
    "<string>"
  ],
  "has_factsheet": true,
  "is_active": true,
  "status": 123,
  "strategy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "as_of_date": "2023-12-25",
  "completed_at": "2023-11-07T05:31:56Z",
  "latest_run_date": "2023-12-25",
  "runs_count": 123,
  "started_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Enter 'Bearer' followed by a space and then your JWT or API Key. Example: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... or Bearer YOUR_API_KEY_HERE

Path Parameters

​
strategyId
string<uuid>
required

UUID of the strategy

Body

application/json

Parameters for submitting a strategy run.

​
as_of_date
string<date>

The as-of date for the run (YYYY-MM-DD). Omitted or today (UTC) -> LIVE; a past date -> HISTORICAL. Future dates are rejected (400).

​
create_factsheet
boolean
default:false

Request factsheet generation for the resulting run.

​
force
boolean
default:false

Re-run even if a completed run already exists for this version/date.

​
priority
integer
default:5

Batch-queue priority for HISTORICAL scheduling (1-10).

Required range: 1 <= x <= 10
​
version_id
string<uuid>

The version to run. Defaults to the version matching the strategy's current draft (created if needed) and promoted to active.

Response

Submission accepted; the submitted version with its run state (id + status/completed/has_factsheet). Poll /versions/{id} for progress.

A saved version of a strategy plus its run state. In rollup mode (no as_of_date) latest_run_date and runs_count are populated; in date-scoped mode (as_of_date supplied) as_of_date is echoed and the rollup-only fields are null.

​
completed
boolean
required
​
created_at
string<date-time>
required
​
description
string
required

The normalized objective snapshot for this version.

​
exclusions
string[]
required
​
has_factsheet
boolean
required
​
is_active
boolean
required

Whether this version is the strategy's active version.

​
status
integer | null
required

Raw run status code (e.g. 1 pending, 100 done, negative failed).

​
strategy_id
string<uuid>
required
​
version_id
string<uuid>
required

The version's id (verbose; pairs with strategy_id, no bare id).

​
as_of_date
string<date> | null

Echoed when date-scoped; absent/null in rollup mode.

​
completed_at
string<date-time> | null
​
latest_run_date
string<date> | null

The version's latest completed run date; null when date-scoped.

​
runs_count
integer | null

Total runs for the version; null when date-scoped.

​
started_at
string<date-time> | null