Skip to main content
POST
Start a VaR report run for a portfolio.

Authorizations

Authorization
string
header
required

OAuth2 access-token requested from AWS Cognito and provided as a Auth Bearer header

Body

The body containing client selections for PortfolioName (non-empty), optional PortfolioType, ReportName (default Historical VaR Report), optional reporting currency, market-data environment names (empty by default), market-data override and real-time flags, report-run and position-filter fields, ConfidenceLevel, Horizon, optional WeightingVarDefinition, and date-time selections for observations, run, pricing, market, portfolio, and historical date rules. Opaque Id and ReportId values are generated when omitted. Report-definition, restriction, report-row-filter, report-type, portfolio identifier and access, provider identifiers and access context, caller, organisation, and UseRealTimeMarketDate fields are server-managed and must not be supplied as independent selections. Supported historical-date rules are required when the corresponding explicit observation date is absent; explicit first and last observation dates must be on or after 2008-07-01. No confidence scale, horizon unit, or numeric range is declared.

Historical-observation and VaR configuration selections for submitting a VaR report run.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.Reports.ApiVarReportJobRequest, Derivitec.Web.Core
id
string<uuid>

Opaque submission identifier; it is distinct from the companion ReportId.

report_id
string<uuid>

Opaque identifier reserved for the report run produced by this submission; it is distinct from the client request identifier.

run_date
string<date-time>

Requested or recorded report-run date; where RunDateIsToday is present and true, that companion flag takes precedence.

pricing_date
string<date-time> | null

Date used to price positions for the report; no time-zone convention is established by this contract.

market_date
string<date-time> | null

Market-data date used or recorded for the report run.

portfolio_date_time
string<date-time> | null

Portfolio snapshot date and time used or recorded for the report; no time-zone convention is established here.

market_data_override
object

Optional market-data substitutions supplied with pricing, risk, or report calculations.

real_time_mkt_data
boolean

Whether the report run uses the exposed real-time market-data selection.

run_date_is_today
boolean

Whether the current day is selected instead of the supplied run date.

report_run_type
enum<string>

How the report run was initiated: on demand, scheduled, or live.

Available options:
on_demand,
scheduled,
live
position_filter_name
string | null

Name of the saved position filter.

position_filter
object

Base selection criterion for a named report-data field.

report_name
string | null

Organisation-scoped name of the report definition to use. The value must not be null or empty.

Example:

"Daily risk overview"

reporting_currency
string | null

Currency in which report values are expressed. When null, the service uses the caller's configured reporting currency or USD.

Example:

"USD"

market_data_environment_names
string[] | null

Names of market-data environments to use for the report. The list is empty by default.

portfolio_name
string | null

Name of the portfolio to select. The value must not be null or empty.

Example:

"Example portfolio"

portfolio_type
enum<string> | null

Portfolio category used to resolve the requested portfolio. It may be omitted when the portfolio name resolves unambiguously.

Available options:
derivitec,
enfusion,
orchestrade,
liquidity_book,
maia,
fund_studio,
not_set
confidence_level
number<double>

Confidence level associated with the VaR report; no scale is established here.

first_observation_date
string<date-time> | null

Explicit first historical observation date, when supplied or recorded.

historical_start_date_rule
string | null

Rule selected for resolving the first historical observation date.

last_observation_date
string<date-time> | null

Explicit last historical observation date, when supplied or recorded.

historical_end_date_rule
string | null

Rule selected for resolving the last historical observation date.

horizon
integer<int32>

Horizon selected for the VaR report; no unit is established here.

weighting_var_definition
object

Configuration used to select VaR weighting behaviour.

Response

Returns the opaque identifier for the started VaR report run in the standard response envelope.

Response envelope for a VaR report-run submission.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.Reports.ApiVarReportJobResponse, Derivitec.Web.Core
is_success
boolean

Whether the operation completed successfully. The default is true; error outcomes set it to false.

Example:

true

error_messages
string[] | null

Messages explaining operation-level failures. The collection is empty by default.

report_id
string<uuid>

Opaque report-run identifier assigned when submission succeeds; otherwise the empty GUID.