Start a VaR report run for a portfolio.
Starts a report run and returns its opaque run identifier while work continues. The separate status operation returns a later point-in-time status; no cancellation operation, polling interval, completion time, or retention period is promised here. Caller identity, organisation, access, and effective market-data context are server-managed.
Authorizations
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.
Derivitec.Web.Core.Reports.ApiVarReportJobRequest, Derivitec.Web.Core Opaque submission identifier; it is distinct from the companion ReportId.
Opaque identifier reserved for the report run produced by this submission; it is distinct from the client request identifier.
Requested or recorded report-run date; where RunDateIsToday is present and true, that companion flag takes precedence.
Date used to price positions for the report; no time-zone convention is established by this contract.
Market-data date used or recorded for the report run.
Portfolio snapshot date and time used or recorded for the report; no time-zone convention is established here.
Optional market-data substitutions supplied with pricing, risk, or report calculations.
Whether the report run uses the exposed real-time market-data selection.
Whether the current day is selected instead of the supplied run date.
How the report run was initiated: on demand, scheduled, or live.
on_demand, scheduled, live Name of the saved position filter.
Base selection criterion for a named report-data field.
- Option 1
- Option 2
- Option 3
- Option 4
Organisation-scoped name of the report definition to use. The value must not be null or empty.
"Daily risk overview"
Currency in which report values are expressed. When null, the service uses the caller's configured reporting currency or USD.
"USD"
Names of market-data environments to use for the report. The list is empty by default.
Name of the portfolio to select. The value must not be null or empty.
"Example portfolio"
Portfolio category used to resolve the requested portfolio. It may be omitted when the portfolio name resolves unambiguously.
derivitec, enfusion, orchestrade, liquidity_book, maia, fund_studio, not_set Confidence level associated with the VaR report; no scale is established here.
Explicit first historical observation date, when supplied or recorded.
Rule selected for resolving the first historical observation date.
Explicit last historical observation date, when supplied or recorded.
Rule selected for resolving the last historical observation date.
Horizon selected for the VaR report; no unit is established here.
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.
Derivitec.Web.Core.Reports.ApiVarReportJobResponse, Derivitec.Web.Core Whether the operation completed successfully. The default is true; error outcomes set it to false.
true
Messages explaining operation-level failures. The collection is empty by default.
Opaque report-run identifier assigned when submission succeeds; otherwise the empty GUID.