> ## Documentation Index > Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve marginal VaR charts grouped by report or requested fields. > Returns the report-defined charts and any supplied custom bar-chart selections. No fixed catalog of accepted grouping or statistic property names is declared by this action. ## OpenAPI ````yaml /risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json post /api/VarReportQuery/MarginalVarByGroup openapi: 3.0.4 info: title: Derivitec Api 1.0 version: '1.0' servers: - url: https://api.riskportal.activeviam.com security: - oauth2: [] - apikey: [] tags: - name: AdminUser - name: AtotiReport - name: AtotiSession - name: BloombergOAuth - name: Bond - name: BondYieldCurvePage - name: BookAccess - name: Books - name: Commodity - name: Counterparties - name: Currencies - name: Equity - name: EquityDividend - name: EquityPage - name: FeatureFlag - name: Fx - name: FxPage - name: GroupAccess - name: Home - name: LegacyPosition - name: MarketData - name: MarketDataProvider - name: MarketDataProviderAccess - name: Meta - name: Notification - name: Organisation - name: PnLReport - name: PortfolioAccess - name: Portfolios - name: Position - name: PositionFilter - name: PricingEnvironment - name: PricingEnvironmentAccess - name: RateAsset - name: RateAssetPage - name: Report - name: ReportDefinition - name: ReportHistoryLauncherQuery - name: ReportLauncher - name: ReportQuery - name: ReportQueryViewUser - name: ReportRestriction - name: ReportView - name: RiskReport - name: Tradable - name: TradeBooking - name: User - name: VarReport - name: VarReportQuery - name: YieldCurvePage paths: /api/VarReportQuery/MarginalVarByGroup: post: tags: - VarReportQuery summary: Retrieve marginal VaR charts grouped by report or requested fields. description: >- Returns the report-defined charts and any supplied custom bar-chart selections. No fixed catalog of accepted grouping or statistic property names is declared by this action. operationId: MarginalVarByGroup requestBody: description: >- The body containing the opaque `ReportId`, optional VaR selection fields, and optional `CustomBarChartDefinitions`; each definition can supply `Id`, `Title`, `GroupProperty`, and `StatisticProperty`. content: application/json-patch+json: schema: $ref: '#/components/schemas/ApiVarReportQueryMarginalVarByGroupRequest' application/json: schema: $ref: '#/components/schemas/ApiVarReportQueryMarginalVarByGroupRequest' text/json: schema: $ref: '#/components/schemas/ApiVarReportQueryMarginalVarByGroupRequest' application/*+json: schema: $ref: '#/components/schemas/ApiVarReportQueryMarginalVarByGroupRequest' responses: '200': description: >- Returns marginal VaR bar charts for the report-defined and requested groupings. content: application/json: schema: $ref: >- #/components/schemas/ApiVarReportQueryMarginalVarByGroupResponse '400': description: BadRequest '401': description: Unauthorized '403': description: Forbidden security: - oauth2: [] - apikey: [] components: schemas: ApiVarReportQueryMarginalVarByGroupRequest: required: - $type type: object properties: confidence_level: type: number description: >- Optional VaR confidence-level override expressed as a decimal fraction; null retains the report's configured level. format: double nullable: true example: 0.99 row_query: $ref: '#/components/schemas/FilterBase' weighting_var_definition: $ref: '#/components/schemas/WeightingVarDefinition' row_restriction_filter: $ref: '#/components/schemas/FilterBase' full_report_filter: $ref: '#/components/schemas/MultiFilter' report_configuration: $ref: '#/components/schemas/VarReportConfiguration' report_id: type: string description: >- Opaque identifier of the report run to retrieve or query. The value must not be null or empty. nullable: true portfolio_type: enum: - derivitec - enfusion - orchestrade - liquidity_book - maia - fund_studio - not_set type: string description: >- Portfolio category used to resolve the requested portfolio. It may be omitted when the portfolio name resolves unambiguously. nullable: true custom_bar_chart_definitions: type: array items: $ref: '#/components/schemas/CustomBarChartDefinition' description: >- Optional additional chart definitions evaluated alongside the report's saved group charts. nullable: true $type: type: string enum: - >- Derivitec.Web.Core.VarReportQuery.ApiVarReportQueryMarginalVarByGroupRequest, Derivitec.Web.Core additionalProperties: false description: >- Requests marginal-VaR bar charts using saved and optional custom grouping definitions. ApiVarReportQueryMarginalVarByGroupResponse: required: - $type type: object properties: is_success: type: boolean description: >- Whether the operation completed successfully. The default is `true`; error outcomes set it to `false`. example: true error_messages: type: array items: type: string description: >- Messages explaining operation-level failures. The collection is empty by default. nullable: true price_histories_count: type: integer description: Number of position price histories used to produce the query result. format: int32 bar_charts: type: array items: $ref: '#/components/schemas/BarChart' description: >- Bar charts produced from the report's saved and requested custom grouping definitions. nullable: true $type: type: string enum: - >- Derivitec.Web.Core.VarReportQuery.ApiVarReportQueryMarginalVarByGroupResponse, Derivitec.Web.Core additionalProperties: false description: Returns marginal-VaR values grouped into bar charts. FilterBase: description: Base selection criterion for a named report-data field. discriminator: propertyName: $type mapping: Derivitec.Web.Core.Filters.Filter, Derivitec.Web.Core: '#/components/schemas/FilterMintlifyShape' Derivitec.Web.Core.Filters.FilterBase, Derivitec.Web.Core: '#/components/schemas/FilterBaseMintlifyShape' Derivitec.Web.Core.Filters.MultiFilter, Derivitec.Web.Core: '#/components/schemas/MultiFilter' Derivitec.Web.Core.Filters.StringFilter, Derivitec.Web.Core: '#/components/schemas/StringFilter' oneOf: - $ref: '#/components/schemas/FilterMintlifyShape' - $ref: '#/components/schemas/FilterBaseMintlifyShape' - $ref: '#/components/schemas/MultiFilter' - $ref: '#/components/schemas/StringFilter' WeightingVarDefinition: required: - $type type: object properties: active: type: boolean description: Whether the VaR weighting configuration is enabled. window_length: type: integer description: Window-length value; no unit is established here. format: int32 decay_period: type: integer description: Decay-period value; no unit is established here. format: int32 scheme: enum: - exponentially_weighted - filtered_historical type: string description: Weighting scheme selected for the historical VaR configuration. $type: type: string enum: - >- Derivitec.Web.Core.Reports.WeightingVarDefinition, Derivitec.Web.Core additionalProperties: false description: Configuration used to select VaR weighting behaviour. MultiFilter: required: - $type type: object properties: field: type: string description: Name of the report-data field evaluated by this criterion. nullable: true operator: enum: - not_set - and - or type: string description: Logical rule used to combine the child criteria. conditions: type: array items: $ref: '#/components/schemas/FilterBase' description: >- Child criteria evaluated by the selected logical operator; nested groups are permitted. nullable: true $type: type: string enum: - Derivitec.Web.Core.Filters.MultiFilter, Derivitec.Web.Core additionalProperties: false description: >- Nested filter group that combines child criteria with a logical operator. VarReportConfiguration: required: - $type type: object properties: name: type: string description: Display name for this report-query or export configuration. nullable: true example: Default row_query: $ref: '#/components/schemas/FilterBase' confidence_level: type: number description: >- Optional VaR confidence-level override expressed as a decimal fraction; null retains the report's configured level. format: double nullable: true example: 0.99 weighting_var_definition: $ref: '#/components/schemas/WeightingVarDefinition' $type: type: string enum: - Derivitec.Web.Core.VarReportConfiguration, Derivitec.Web.Core additionalProperties: false description: >- Optional named overrides used when querying or exporting a historical VaR report. CustomBarChartDefinition: required: - $type type: object properties: id: type: string description: Client-assigned identifier for the chart definition. nullable: true example: chart-1 title: type: string description: Human-readable title for the custom chart. nullable: true group_property: type: string description: Position property name used to group chart values. nullable: true statistic_property: type: string description: VaR-statistics property name represented by the chart. nullable: true $type: type: string enum: - >- Derivitec.Web.Core.VarReportQuery.CustomBarChartDefinition, Derivitec.Web.Core additionalProperties: false description: Defines an additional grouping and statistic for a VaR report bar chart. BarChart: required: - $type type: object properties: categories: type: array items: type: string description: >- Ordered group labels for the bars; each entry aligns by index with `values`. nullable: true id: type: string description: Identifier of the chart definition that produced this result. nullable: true statistic_property: type: string description: VaR-statistics property name represented by the bar values. nullable: true format: type: string description: Display-format string associated with the chart's statistic values. nullable: true title: type: string description: Human-readable chart title. nullable: true values: type: array items: type: number format: double description: >- Ordered statistic values; each entry aligns by index with `categories`. nullable: true group_name_property: type: string description: Position property name used to form the chart's categories. nullable: true take_n: type: integer description: Configured number of sorted groups to display for the chart. format: int32 $type: type: string enum: - Derivitec.Web.Core.VarReportQuery.BarChart, Derivitec.Web.Core additionalProperties: false description: Represents grouped VaR statistic values for a client bar chart. FilterMintlifyShape: required: - $type type: object properties: field: type: string description: Name of the report-data field evaluated by this criterion. nullable: true type: type: string nullable: true $type: type: string enum: - Derivitec.Web.Core.Filters.Filter, Derivitec.Web.Core additionalProperties: false FilterBaseMintlifyShape: required: - $type type: object properties: field: type: string description: Name of the report-data field evaluated by this criterion. nullable: true $type: type: string enum: - Derivitec.Web.Core.Filters.FilterBase, Derivitec.Web.Core additionalProperties: false description: Base selection criterion for a named report-data field. StringFilter: required: - $type type: object properties: field: type: string description: Name of the report-data field evaluated by this criterion. nullable: true type: type: string nullable: true filter: type: string nullable: true $type: type: string enum: - Derivitec.Web.Core.Filters.StringFilter, Derivitec.Web.Core additionalProperties: false securitySchemes: oauth2: type: oauth2 description: >- OAuth2 access-token requested from AWS Cognito and provided as a Auth Bearer header flows: implicit: authorizationUrl: https://auth.riskportal.derivitec.com/oauth2/authorize scopes: {} apikey: type: apiKey description: API-Key requested via the site and provided as a header name: x-api-key in: header ````