> ## 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.

# Submit a risk report run.

> Submits a run and returns its opaque report-run identifier; it does not return risk-result rows or wait for
completion. Run, pricing, and market date-time inputs are interpreted as calendar dates, while an explicit
portfolio date-time is normalised to the end of its calendar day. `RunDateIsToday` or
`RealTimeMktData` replaces the run date with today. Clients should retain the response
`ReportId` as the authoritative run key; the request `Id` is a submission identifier and is not
the key for later report queries.



## OpenAPI

````yaml /risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json post /api/RiskReport/RunReport
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/RiskReport/RunReport:
    post:
      tags:
        - RiskReport
      summary: Submit a risk report run.
      description: >-
        Submits a run and returns its opaque report-run identifier; it does not
        return risk-result rows or wait for

        completion. Run, pricing, and market date-time inputs are interpreted as
        calendar dates, while an explicit

        portfolio date-time is normalised to the end of its calendar day.
        `RunDateIsToday` or

        `RealTimeMktData` replaces the run date with today. Clients should
        retain the response

        `ReportId` as the authoritative run key; the request `Id` is a
        submission identifier and is not

        the key for later report queries.
      operationId: RunReport
      requestBody:
        description: >-
          The body containing an accessible `ReportName` and `PortfolioName`;
          optional `PortfolioType`; optional `ReportingCurrency`, which defaults
          to the caller preference and then `USD`; optional accessible
          `MarketDataEnvironmentNames`; run, pricing, market, and portfolio
          dates; optional `ReportCutoff`; optional market-data override; and
          either a custom position filter or accessible `PositionFilterName`. A
          blank cutoff means none and an unknown nonblank name produces an
          unsuccessful envelope. Report-definition, restriction, provider,
          cutoff identifier, portfolio identifier, and caller fields are
          server-managed. The exposed report-run type does not establish client
          authority to select scheduling modes.
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/ApiRiskReportJobRequest'
          application/json:
            schema:
              $ref: '#/components/schemas/ApiRiskReportJobRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/ApiRiskReportJobRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/ApiRiskReportJobRequest'
      responses:
        '200':
          description: >-
            Returns the submitted report-run identifier, or an unsuccessful
            envelope for unavailable selectors, invalid override or filter
            values, cutoff validation, or rejected submission; no result rows or
            completion timestamp is included.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiRiskReportJobResponse'
        '400':
          description: BadRequest
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
        - oauth2: []
        - apikey: []
components:
  schemas:
    ApiRiskReportJobRequest:
      required:
        - $type
      type: object
      properties:
        id:
          type: string
          description: >-
            Opaque submission identifier; it is distinct from the companion
            ReportId.
          format: uuid
        report_id:
          type: string
          description: >-
            Opaque identifier reserved for the report run produced by this
            submission; it is distinct from the client request identifier.
          format: uuid
        run_date:
          type: string
          description: >-
            Requested or recorded report-run date; where RunDateIsToday is
            present and true, that companion flag takes precedence.
          format: date-time
        pricing_date:
          type: string
          description: >-
            Date used to price positions for the report; no time-zone convention
            is established by this contract.
          format: date-time
          nullable: true
        market_date:
          type: string
          description: Market-data date used or recorded for the report run.
          format: date-time
          nullable: true
        portfolio_date_time:
          type: string
          description: >-
            Portfolio snapshot date and time used or recorded for the report; no
            time-zone convention is established here.
          format: date-time
          nullable: true
        market_data_override:
          $ref: '#/components/schemas/MarketDataOverride'
        real_time_mkt_data:
          type: boolean
          description: >-
            Whether the report run uses the exposed real-time market-data
            selection.
        run_date_is_today:
          type: boolean
          description: >-
            Whether the current day is selected instead of the supplied run
            date.
        report_run_type:
          enum:
            - on_demand
            - scheduled
            - live
          type: string
          description: 'How the report run was initiated: on demand, scheduled, or live.'
        position_filter_name:
          type: string
          description: Name of the saved position filter.
          nullable: true
        position_filter:
          $ref: '#/components/schemas/FilterBase'
        report_name:
          type: string
          description: >-
            Organisation-scoped name of the report definition to use. The value
            must not be null or empty.
          nullable: true
          example: Daily risk overview
        reporting_currency:
          type: string
          description: >-
            Currency in which report values are expressed. When null, the
            service uses the caller's configured reporting currency or USD.
          nullable: true
          example: USD
        market_data_environment_names:
          type: array
          items:
            type: string
          description: >-
            Names of market-data environments to use for the report. The list is
            empty by default.
          nullable: true
        portfolio_name:
          type: string
          description: >-
            Name of the portfolio to select. The value must not be null or
            empty.
          nullable: true
          example: Example portfolio
        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
        report_cutoff:
          type: string
          description: Display name for the selected report cutoff.
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.Reports.ApiRiskReportJobRequest,
              Derivitec.Web.Core
      additionalProperties: false
      description: Cutoff selection for submitting a risk report run.
    ApiRiskReportJobResponse:
      required:
        - $type
      type: object
      additionalProperties: false
      description: Response envelope for a risk report-run submission.
      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
        report_id:
          type: string
          description: >-
            Opaque report-run identifier assigned when submission succeeds;
            otherwise the empty GUID.
          format: uuid
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.Reports.ApiRiskReportJobResponse,
              Derivitec.Web.Core
    MarketDataOverride:
      required:
        - $type
      type: object
      properties:
        bond_prices:
          type: array
          items:
            $ref: '#/components/schemas/BondDataExternal'
          description: Replacement bond observations supplied to the calculation.
          nullable: true
        bond_yield_curve_overrides:
          type: array
          items:
            $ref: '#/components/schemas/BondYieldCurveOverride'
          description: Replacement bond yield curves supplied by currency.
          nullable: true
        discount_curve_overrides:
          type: array
          items:
            $ref: '#/components/schemas/DiscountCurveOverride'
          description: Replacement discount curves supplied by currency.
          nullable: true
        discount_curve_fitting_overrides:
          type: array
          items:
            $ref: '#/components/schemas/CurveFittingOverride'
          description: Replacement discount-curve fitting inputs supplied by currency.
          nullable: true
        index_curve_overrides:
          type: array
          items:
            $ref: '#/components/schemas/DiscountCurveOverride'
          description: Replacement index curves supplied by rate-asset code.
          nullable: true
        index_curve_fitting_overrides:
          type: array
          items:
            $ref: '#/components/schemas/CurveFittingOverride'
          description: Replacement index-curve fitting inputs supplied by rate-asset code.
          nullable: true
        equity_spot_overrides:
          type: array
          items:
            $ref: '#/components/schemas/InstrumentIdentifierDoubleKeyValuePair'
          description: >-
            Replacement equity spot values paired with qualified equity
            identifiers. Pricing-detail requests require each supplied value to
            be positive.
          nullable: true
        equity_vol_grid_overrides:
          type: array
          items:
            $ref: '#/components/schemas/EquityVolGrid'
          description: Replacement equity volatility grids supplied to the calculation.
          nullable: true
        equity_vol_surface_overrides:
          type: array
          items:
            $ref: '#/components/schemas/EquityVolSurface'
          description: Replacement equity volatility surfaces supplied to the calculation.
          nullable: true
        equity_vol_of_var_curve_overrides:
          type: array
          items:
            $ref: '#/components/schemas/EquityVolOfVarCurve'
          description: >-
            Request-scoped replacement volatility-of-variance curves for
            qualified equity/index identifiers.

            Null or empty leaves stored marks unchanged. Each curve replaces the
            complete curve on its reference

            date, taking precedence over provider fallback without uploading
            data. Only curves matching the

            calculation pricing/as-of date apply; other reference dates are
            ignored. Maturities must be positive,

            strictly increasing calendar-day counts with matching finite,
            non-negative decimal volatilities.

            Zero volatility removes the volatility-of-variance convexity
            adjustment. Duplicate underlying/date

            pairs and unsupported identifiers fail conversion. ProviderId is
            metadata, not an environment selector.
          nullable: true
        equity_vol_surface_spot_model:
          enum:
            - sticky_strike
            - sticky_delta
            - sticky_smile_ratio
          type: string
          description: >-
            Spot-response model selected for replacement equity volatility
            surfaces. Defaults to sticky_strike.
        borrow_curve_overrides:
          type: array
          items:
            $ref: '#/components/schemas/BorrowCurveOverride'
          description: Replacement equity borrow curves supplied to the calculation.
          nullable: true
        dividends_overrides:
          type: array
          items:
            $ref: '#/components/schemas/DividendsOverride'
          description: Replacement dividend curves supplied to the calculation.
          nullable: true
        cmdty_spot_overrides:
          type: array
          items:
            $ref: '#/components/schemas/StringDoubleKeyValuePair'
          description: Replacement commodity spot values supplied by commodity-code prefix.
          nullable: true
        fx_spot_currency:
          type: string
          description: >-
            Three-character common currency in which all FX spot overrides are
            expressed; required when overrides are supplied.
          nullable: true
        fx_spot_overrides_by_currency:
          type: array
          items:
            $ref: '#/components/schemas/StringDoubleKeyValuePair'
          description: >-
            FX spot values keyed by distinct three-character currencies and
            expressed against FxSpotCurrency.
          nullable: true
        andersen_buffum_parameters_overrides:
          type: array
          items:
            $ref: '#/components/schemas/AndersenBuffumParameters'
          description: >-
            Replacement Andersen-Buffum parameter sets supplied to the
            calculation.
          nullable: true
        recovery_rate_overrides:
          type: array
          items:
            $ref: '#/components/schemas/InstrumentIdentifierDoubleKeyValuePair'
          description: >-
            Replacement recovery-rate values paired with qualified instrument
            identifiers.
          nullable: true
        equity_fx_correlation_overrides:
          type: array
          items:
            $ref: '#/components/schemas/EquityFxCorrelationData'
          description: Replacement equity-to-FX correlations supplied to the calculation.
          nullable: true
        equity_equity_correlation_overrides:
          type: array
          items:
            $ref: '#/components/schemas/EquityEquityCorrelationData'
          description: >-
            Replacement equity-to-equity correlations supplied to the
            calculation.
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.MarketDataOverride,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Optional market-data substitutions supplied with pricing, risk, or
        report calculations.
    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'
    BondDataExternal:
      required:
        - $type
      type: object
      properties:
        provider_id:
          type: string
          description: >-
            Market-data provider code recorded as the source of the
            contribution. Defaults to Derivitec.
          nullable: true
        derivitec_created:
          type: string
          description: Timestamp at which the market-data record was created.
        derivitec_modified:
          type: string
          description: Optional timestamp of the record's latest modification.
          nullable: true
        uploaded_date_time:
          type: string
          description: >-
            Optional timestamp at which the contribution was uploaded.
            UploadRateAssets ignores the supplied value on each rate asset and
            stores the current UTC time.
          nullable: true
        derivitec_modified_by:
          type: string
          description: >-
            Principal recorded as the latest modifier. UploadRateAssets ignores
            the supplied value on each rate asset and stores the authenticated
            user identifier.
          nullable: true
        uploaded_by:
          type: string
          description: >-
            Principal recorded as the uploader. UploadRateAssets ignores the
            supplied value on each rate asset and stores the authenticated user
            identifier.
          nullable: true
        rolled:
          type: boolean
          description: Whether the contribution has been rolled.
          example: false
        bond_identifier:
          $ref: '#/components/schemas/InstrumentIdentifier'
        currency:
          type: string
          description: Currency of the submitted bond price.
          nullable: true
        traded_price:
          type: number
          description: >-
            Submitted bond price interpreted using the bond's reference
            quotation convention and IsPercentageOfPar.
          format: double
        date:
          type: string
          description: Observation date.
          format: date-time
        is_percentage_of_par:
          type: boolean
          description: >-
            Whether TradedPrice uses percentage-of-par quotation; this value
            must match the bond's reference quotation convention.
        is_currency_per_bond_unit:
          type: boolean
          description: >-
            Legacy compatibility field with no observable effect in the public
            bond-price operations.
        fitting_mode:
          enum:
            - fit_credit_spread
            - fit_vol_surface
          type: string
          description: >-
            Whether the price is used to fit credit-spread or volatility-surface
            data; defaults to FitCreditSpread.
        $type:
          type: string
          enum:
            - Derivitec.Web.Core.MarketData.BondDataExternal, Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Dated bond-price input whose IsPercentageOfPar value must match the
        bond's reference quotation convention.
    BondYieldCurveOverride:
      required:
        - $type
      type: object
      properties:
        currency:
          type: string
          description: >-
            Exactly three characters identifying the replacement curve's
            currency.
          nullable: true
        discount_factors:
          type: array
          items:
            type: number
            format: double
          description: Nonempty dimensionless factors aligned one-for-one with Maturities.
          nullable: true
        maturities:
          type: array
          items:
            type: integer
            format: int32
          description: >-
            Nonempty distinct day-offset maturities aligned one-for-one with
            DiscountFactors.
          nullable: true
        bond_issuer:
          type: string
          description: Issuer selected for the replacement curve.
          nullable: true
        debt_type:
          type: string
          description: >-
            Debt seniority or debt-type classification used to distinguish
            issuer curves.
          nullable: true
        bond_identifier:
          $ref: '#/components/schemas/InstrumentIdentifier'
        reference_curve_name:
          type: string
          description: >-
            Name of the curve supplying the reference coordinates. It is
            required when reference coordinates are supplied, cannot contain
            underscores, and is initialized to a generated unique value when
            omitted.
          nullable: true
        reference_curve_discount_factors:
          type: array
          items:
            type: number
            format: double
          description: >-
            Nonempty dimensionless reference-curve factors aligned one-for-one
            with ReferenceCurveMaturities.
          nullable: true
        reference_curve_maturities:
          type: array
          items:
            type: integer
            format: int32
          description: >-
            Nonempty distinct reference-curve maturities as day offsets, aligned
            one-for-one with ReferenceCurveDiscountFactors.
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.BondYieldCurveOverride,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Replacement issuer-curve input requiring either a bond issuer or bond
        identifier and a complete primary or reference curve coordinate set.
    DiscountCurveOverride:
      required:
        - $type
      type: object
      properties:
        currency:
          type: string
          description: >-
            Exactly three characters identifying the replacement curve's
            currency.
          nullable: true
        discount_factors:
          type: array
          items:
            type: number
            format: double
          description: Nonempty dimensionless factors aligned one-for-one with Maturities.
          nullable: true
        maturities:
          type: array
          items:
            type: integer
            format: int32
          description: >-
            Nonempty distinct day-offset maturities aligned one-for-one with
            DiscountFactors.
          nullable: true
        curve_name:
          type: string
          description: Name distinguishing the curve within its currency.
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.DiscountCurveOverride,
              Derivitec.Web.Core
      additionalProperties: false
      description: Named replacement discount curve.
    CurveFittingOverride:
      required:
        - $type
      type: object
      properties:
        currency:
          type: string
          description: Three-character currency code of the curve being fitted.
          nullable: true
        curve_name:
          type: string
          description: Name distinguishing the curve within its currency.
          nullable: true
        provider_id:
          type: string
          description: Data-provider selector.
          nullable: true
        instrument_set:
          type: array
          items:
            $ref: '#/components/schemas/InstrumentIdentifier'
          description: Replacement instruments used for curve fitting.
          nullable: true
        instrument_quotes:
          type: array
          items:
            $ref: '#/components/schemas/InstrumentIdentifierDoubleKeyValuePair'
          description: Replacement quotes used for curve fitting.
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.CurveFittingOverride,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Overrides the provider, instrument set, and quotes used when fitting a
        named currency curve.
    InstrumentIdentifierDoubleKeyValuePair:
      type: object
      properties:
        key:
          $ref: '#/components/schemas/InstrumentIdentifier'
        value:
          type: number
          format: double
      additionalProperties: false
    EquityVolGrid:
      required:
        - $type
      type: object
      properties:
        provider_id:
          type: string
          description: >-
            Market-data provider code recorded as the source of the
            contribution. Defaults to Derivitec.
          nullable: true
        derivitec_created:
          type: string
          description: Timestamp at which the market-data record was created.
        derivitec_modified:
          type: string
          description: Optional timestamp of the record's latest modification.
          nullable: true
        uploaded_date_time:
          type: string
          description: >-
            Optional timestamp at which the contribution was uploaded.
            UploadRateAssets ignores the supplied value on each rate asset and
            stores the current UTC time.
          nullable: true
        derivitec_modified_by:
          type: string
          description: >-
            Principal recorded as the latest modifier. UploadRateAssets ignores
            the supplied value on each rate asset and stores the authenticated
            user identifier.
          nullable: true
        uploaded_by:
          type: string
          description: >-
            Principal recorded as the uploader. UploadRateAssets ignores the
            supplied value on each rate asset and stores the authenticated user
            identifier.
          nullable: true
        rolled:
          type: boolean
          description: Whether the contribution has been rolled.
          example: false
        maturities:
          type: array
          items:
            type: integer
            format: int32
          description: >-
            Maturity offsets from ReferenceDate, in calendar days, corresponding
            by position to the volatility rows.
          nullable: true
        reference_date:
          type: string
          description: Reference date of the volatility grid.
          format: date-time
        strikes:
          type: array
          items:
            type: array
            items:
              type: number
              format: double
          description: >-
            One strike row shared by all maturities, or one row per maturity;
            each row aligns with the corresponding volatility row.
          nullable: true
        strike_type:
          enum:
            - absolute
            - percent_spot
            - percent_forward
          type: string
          description: Coordinate convention used by the strike rows. Defaults to absolute.
        vols:
          type: array
          items:
            type: array
            items:
              type: number
              format: double
          description: >-
            Rows of positive volatility values as decimals; 0.20 means 20%. Rows
            match the strike-row shape and correspond by position to maturities.
          nullable: true
        use_spline:
          type: boolean
          description: Whether the grid is marked for spline use.
          example: false
        spot_ref:
          type: number
          description: Optional spot reference carried by the volatility grid.
          format: double
          nullable: true
        asset_id:
          $ref: '#/components/schemas/InstrumentIdentifier'
        $type:
          type: string
          enum:
            - Derivitec.Web.Core.MarketData.EquityVolGrid, Derivitec.Web.Core
      additionalProperties: false
      description: Equity volatility grid identified by its equity asset.
    EquityVolSurface:
      description: >-
        Equity volatility surface with benchmark coordinates and a spot
        reference.
      discriminator:
        propertyName: $type
        mapping:
          Derivitec.Web.Core.MarketData.EquityVolSurface, Derivitec.Web.Core: '#/components/schemas/EquityVolSurfaceMintlifyShape'
          Derivitec.Web.Core.MarketData.EquityVolSurfaceSpline, Derivitec.Web.Core: '#/components/schemas/EquityVolSurfaceSpline'
          Derivitec.Web.Core.MarketData.EquityVolSurfaceSvi, Derivitec.Web.Core: '#/components/schemas/EquityVolSurfaceSvi'
      oneOf:
        - $ref: '#/components/schemas/EquityVolSurfaceMintlifyShape'
        - $ref: '#/components/schemas/EquityVolSurfaceSpline'
        - $ref: '#/components/schemas/EquityVolSurfaceSvi'
    EquityVolOfVarCurve:
      required:
        - $type
      type: object
      properties:
        provider_id:
          type: string
          description: >-
            Market-data provider code recorded as the source of the
            contribution. Defaults to Derivitec.
          nullable: true
        derivitec_created:
          type: string
          description: Timestamp at which the market-data record was created.
        derivitec_modified:
          type: string
          description: Optional timestamp of the record's latest modification.
          nullable: true
        uploaded_date_time:
          type: string
          description: >-
            Optional timestamp at which the contribution was uploaded.
            UploadRateAssets ignores the supplied value on each rate asset and
            stores the current UTC time.
          nullable: true
        derivitec_modified_by:
          type: string
          description: >-
            Principal recorded as the latest modifier. UploadRateAssets ignores
            the supplied value on each rate asset and stores the authenticated
            user identifier.
          nullable: true
        uploaded_by:
          type: string
          description: >-
            Principal recorded as the uploader. UploadRateAssets ignores the
            supplied value on each rate asset and stores the authenticated user
            identifier.
          nullable: true
        rolled:
          type: boolean
          description: Whether the contribution has been rolled.
          example: false
        maturities:
          type: array
          items:
            type: integer
            format: int32
          description: >-
            Strictly increasing maturity offsets from ReferenceDate, in calendar
            days, corresponding by position to the volatility values.
          nullable: true
        reference_date:
          type: string
          description: Reference date of the volatility curve.
          format: date-time
        vols:
          type: array
          items:
            type: number
            format: double
          description: >-
            Volatility values as decimals; 0.20 means 20%. Values correspond by
            position to maturities.
          nullable: true
        spot_ref:
          type: number
          description: Optional spot reference carried by the volatility curve.
          format: double
          nullable: true
        eq_vol_of_var_index_id:
          $ref: '#/components/schemas/InstrumentIdentifier'
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.EquityVolOfVarCurve,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Volatility-of-variance curve for an identified equity
        volatility-of-variance index.
    BorrowCurveOverride:
      required:
        - $type
      type: object
      properties:
        currency:
          type: string
          description: >-
            Exactly three characters identifying the replacement curve's
            currency.
          nullable: true
        discount_factors:
          type: array
          items:
            type: number
            format: double
          description: Nonempty dimensionless factors aligned one-for-one with Maturities.
          nullable: true
        maturities:
          type: array
          items:
            type: integer
            format: int32
          description: >-
            Nonempty distinct day-offset maturities aligned one-for-one with
            DiscountFactors.
          nullable: true
        asset_identifier:
          $ref: '#/components/schemas/InstrumentIdentifier'
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.BorrowCurveOverride,
              Derivitec.Web.Core
      additionalProperties: false
      description: Replacement borrow-curve input for one asset.
    DividendsOverride:
      required:
        - $type
      type: object
      properties:
        asset_identifier:
          $ref: '#/components/schemas/InstrumentIdentifier'
        dividends:
          $ref: '#/components/schemas/Dividends'
        dividend_yields:
          type: array
          items:
            $ref: '#/components/schemas/Int32DoubleKeyValuePair'
          description: >-
            Continuously compounded dividend-yield adjustments applied
            independently of any explicit dividends.
          nullable: true
        use_forward_dividend_yields:
          type: boolean
          description: >-
            Whether DividendYields are interpreted as forward rather than zero
            rates; defaults to `true`.
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.DividendsOverride,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Projected-dividend schedule and/or continuously compounded
        dividend-yield adjustments for one asset.
    StringDoubleKeyValuePair:
      type: object
      properties:
        key:
          type: string
          nullable: true
        value:
          type: number
          format: double
      additionalProperties: false
    AndersenBuffumParameters:
      required:
        - $type
      type: object
      properties:
        provider_id:
          type: string
          description: >-
            Market-data provider code recorded as the source of the
            contribution. Defaults to Derivitec.
          nullable: true
        derivitec_created:
          type: string
          description: Timestamp at which the market-data record was created.
        derivitec_modified:
          type: string
          description: Optional timestamp of the record's latest modification.
          nullable: true
        uploaded_date_time:
          type: string
          description: >-
            Optional timestamp at which the contribution was uploaded.
            UploadRateAssets ignores the supplied value on each rate asset and
            stores the current UTC time.
          nullable: true
        derivitec_modified_by:
          type: string
          description: >-
            Principal recorded as the latest modifier. UploadRateAssets ignores
            the supplied value on each rate asset and stores the authenticated
            user identifier.
          nullable: true
        uploaded_by:
          type: string
          description: >-
            Principal recorded as the uploader. UploadRateAssets ignores the
            supplied value on each rate asset and stores the authenticated user
            identifier.
          nullable: true
        rolled:
          type: boolean
          description: Whether the contribution has been rolled.
          example: false
        andersen_buffum_alpha:
          type: number
          description: Alpha input of the Andersen–Buffum representation.
          format: double
        andersen_buffum_benchmark_spot:
          type: number
          description: Benchmark spot input of the Andersen–Buffum representation.
          format: double
        asset_name:
          $ref: '#/components/schemas/InstrumentIdentifier'
        reference_date:
          type: string
          description: Date to which the data applies.
          format: date-time
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.AndersenBuffumParameters,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Andersen–Buffum equity-volatility representation inputs at a reference
        date.
    EquityFxCorrelationData:
      required:
        - $type
      type: object
      properties:
        provider_id:
          type: string
          description: >-
            Market-data provider code recorded as the source of the
            contribution. Defaults to Derivitec.
          nullable: true
        derivitec_created:
          type: string
          description: Timestamp at which the market-data record was created.
        derivitec_modified:
          type: string
          description: Optional timestamp of the record's latest modification.
          nullable: true
        uploaded_date_time:
          type: string
          description: >-
            Optional timestamp at which the contribution was uploaded.
            UploadRateAssets ignores the supplied value on each rate asset and
            stores the current UTC time.
          nullable: true
        derivitec_modified_by:
          type: string
          description: >-
            Principal recorded as the latest modifier. UploadRateAssets ignores
            the supplied value on each rate asset and stores the authenticated
            user identifier.
          nullable: true
        uploaded_by:
          type: string
          description: >-
            Principal recorded as the uploader. UploadRateAssets ignores the
            supplied value on each rate asset and stores the authenticated user
            identifier.
          nullable: true
        rolled:
          type: boolean
          description: Whether the contribution has been rolled.
          example: false
        correlation:
          type: number
          description: >-
            Unitless correlation between the two selected instruments, in the
            range -1 to 1.
          format: double
        date:
          type: string
          description: Observation date.
          format: date-time
        equity_identifier:
          $ref: '#/components/schemas/InstrumentIdentifier'
        currency:
          type: string
          description: >-
            Currency used with the equity's listing currency to select the FX
            cross.
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.EquityFxCorrelationData,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Dated correlation between an identified equity and a currency-derived FX
        cross.
    EquityEquityCorrelationData:
      required:
        - $type
      type: object
      properties:
        provider_id:
          type: string
          description: >-
            Market-data provider code recorded as the source of the
            contribution. Defaults to Derivitec.
          nullable: true
        derivitec_created:
          type: string
          description: Timestamp at which the market-data record was created.
        derivitec_modified:
          type: string
          description: Optional timestamp of the record's latest modification.
          nullable: true
        uploaded_date_time:
          type: string
          description: >-
            Optional timestamp at which the contribution was uploaded.
            UploadRateAssets ignores the supplied value on each rate asset and
            stores the current UTC time.
          nullable: true
        derivitec_modified_by:
          type: string
          description: >-
            Principal recorded as the latest modifier. UploadRateAssets ignores
            the supplied value on each rate asset and stores the authenticated
            user identifier.
          nullable: true
        uploaded_by:
          type: string
          description: >-
            Principal recorded as the uploader. UploadRateAssets ignores the
            supplied value on each rate asset and stores the authenticated user
            identifier.
          nullable: true
        rolled:
          type: boolean
          description: Whether the contribution has been rolled.
          example: false
        correlation:
          type: number
          description: >-
            Unitless correlation between the two selected instruments, in the
            range -1 to 1.
          format: double
        date:
          type: string
          description: Observation date.
          format: date-time
        asset1_identifier:
          $ref: '#/components/schemas/InstrumentIdentifier'
        asset2_identifier:
          $ref: '#/components/schemas/InstrumentIdentifier'
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.EquityEquityCorrelationData,
              Derivitec.Web.Core
      additionalProperties: false
      description: Dated correlation between two identified equities.
    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.
    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.
    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
    InstrumentIdentifier:
      description: >-
        Instrument code qualified by an identifier namespace and optional market
        code.
      discriminator:
        propertyName: $type
        mapping:
          Derivitec.Web.Core.MarketData.InstrumentIdentifier, Derivitec.Web.Core: '#/components/schemas/InstrumentIdentifierMintlifyShape'
          Derivitec.Web.Core.MarketData.InstrumentInfo, Derivitec.Web.Core: '#/components/schemas/InstrumentInfo'
      oneOf:
        - $ref: '#/components/schemas/InstrumentIdentifierMintlifyShape'
        - $ref: '#/components/schemas/InstrumentInfo'
    EquityVolSurfaceMintlifyShape:
      required:
        - $type
      type: object
      properties:
        provider_id:
          type: string
          description: >-
            Market-data provider code recorded as the source of the
            contribution. Defaults to Derivitec.
          nullable: true
        derivitec_created:
          type: string
          description: Timestamp at which the market-data record was created.
        derivitec_modified:
          type: string
          description: Optional timestamp of the record's latest modification.
          nullable: true
        uploaded_date_time:
          type: string
          description: >-
            Optional timestamp at which the contribution was uploaded.
            UploadRateAssets ignores the supplied value on each rate asset and
            stores the current UTC time.
          nullable: true
        derivitec_modified_by:
          type: string
          description: >-
            Principal recorded as the latest modifier. UploadRateAssets ignores
            the supplied value on each rate asset and stores the authenticated
            user identifier.
          nullable: true
        uploaded_by:
          type: string
          description: >-
            Principal recorded as the uploader. UploadRateAssets ignores the
            supplied value on each rate asset and stores the authenticated user
            identifier.
          nullable: true
        rolled:
          type: boolean
          description: Whether the contribution has been rolled.
          example: false
        asset_name:
          $ref: '#/components/schemas/InstrumentIdentifier'
        benchmark_fwd_factors:
          type: array
          items:
            type: number
            format: double
          description: >-
            Benchmark forward-factor values, one corresponding by position to
            each benchmark maturity.
          nullable: true
        benchmark_maturities:
          type: array
          items:
            type: integer
            format: int32
          description: >-
            Distinct benchmark maturity offsets from ReferenceDate, in calendar
            days.
          nullable: true
        reference_date:
          type: string
          description: Reference date of the equity volatility surface.
          format: date-time
        spot_ref:
          type: number
          description: Spot reference carried by the equity volatility surface.
          format: double
        $type:
          type: string
          enum:
            - Derivitec.Web.Core.MarketData.EquityVolSurface, Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Equity volatility surface with benchmark coordinates and a spot
        reference.
    EquityVolSurfaceSpline:
      required:
        - $type
      type: object
      properties:
        provider_id:
          type: string
          description: >-
            Market-data provider code recorded as the source of the
            contribution. Defaults to Derivitec.
          nullable: true
        derivitec_created:
          type: string
          description: Timestamp at which the market-data record was created.
        derivitec_modified:
          type: string
          description: Optional timestamp of the record's latest modification.
          nullable: true
        uploaded_date_time:
          type: string
          description: >-
            Optional timestamp at which the contribution was uploaded.
            UploadRateAssets ignores the supplied value on each rate asset and
            stores the current UTC time.
          nullable: true
        derivitec_modified_by:
          type: string
          description: >-
            Principal recorded as the latest modifier. UploadRateAssets ignores
            the supplied value on each rate asset and stores the authenticated
            user identifier.
          nullable: true
        uploaded_by:
          type: string
          description: >-
            Principal recorded as the uploader. UploadRateAssets ignores the
            supplied value on each rate asset and stores the authenticated user
            identifier.
          nullable: true
        rolled:
          type: boolean
          description: Whether the contribution has been rolled.
          example: false
        asset_name:
          $ref: '#/components/schemas/InstrumentIdentifier'
        benchmark_fwd_factors:
          type: array
          items:
            type: number
            format: double
          description: >-
            Benchmark forward-factor values, one corresponding by position to
            each benchmark maturity.
          nullable: true
        benchmark_maturities:
          type: array
          items:
            type: integer
            format: int32
          description: >-
            Distinct benchmark maturity offsets from ReferenceDate, in calendar
            days.
          nullable: true
        reference_date:
          type: string
          description: Reference date of the equity volatility surface.
          format: date-time
        spot_ref:
          type: number
          description: Spot reference carried by the equity volatility surface.
          format: double
        var_grid:
          type: array
          items:
            type: array
            items:
              type: number
              format: double
          description: The volatility grid (one vector per maturity)
          nullable: true
        strike_grid:
          type: array
          items:
            type: array
            items:
              type: number
              format: double
          description: The strike grid (one vector per maturity)
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.EquityVolSurfaceSpline,
              Derivitec.Web.Core
      additionalProperties: false
      description: The equity vol surface.
    EquityVolSurfaceSvi:
      required:
        - $type
      type: object
      properties:
        provider_id:
          type: string
          description: >-
            Market-data provider code recorded as the source of the
            contribution. Defaults to Derivitec.
          nullable: true
        derivitec_created:
          type: string
          description: Timestamp at which the market-data record was created.
        derivitec_modified:
          type: string
          description: Optional timestamp of the record's latest modification.
          nullable: true
        uploaded_date_time:
          type: string
          description: >-
            Optional timestamp at which the contribution was uploaded.
            UploadRateAssets ignores the supplied value on each rate asset and
            stores the current UTC time.
          nullable: true
        derivitec_modified_by:
          type: string
          description: >-
            Principal recorded as the latest modifier. UploadRateAssets ignores
            the supplied value on each rate asset and stores the authenticated
            user identifier.
          nullable: true
        uploaded_by:
          type: string
          description: >-
            Principal recorded as the uploader. UploadRateAssets ignores the
            supplied value on each rate asset and stores the authenticated user
            identifier.
          nullable: true
        rolled:
          type: boolean
          description: Whether the contribution has been rolled.
          example: false
        asset_name:
          $ref: '#/components/schemas/InstrumentIdentifier'
        benchmark_fwd_factors:
          type: array
          items:
            type: number
            format: double
          description: >-
            Benchmark forward-factor values, one corresponding by position to
            each benchmark maturity.
          nullable: true
        benchmark_maturities:
          type: array
          items:
            type: integer
            format: int32
          description: >-
            Distinct benchmark maturity offsets from ReferenceDate, in calendar
            days.
          nullable: true
        reference_date:
          type: string
          description: Reference date of the equity volatility surface.
          format: date-time
        spot_ref:
          type: number
          description: Spot reference carried by the equity volatility surface.
          format: double
        call_wings:
          type: array
          items:
            type: number
            format: double
          description: >-
            Non-negative call-wing parameter values, one corresponding by
            position to each benchmark maturity.
          nullable: true
        put_wings:
          type: array
          items:
            type: number
            format: double
          description: >-
            Non-negative put-wing parameter values, one corresponding by
            position to each benchmark maturity.
          nullable: true
        skews:
          type: array
          items:
            type: number
            format: double
          description: >-
            Skew parameter values, one corresponding by position to each
            benchmark maturity.
          nullable: true
        smiles:
          type: array
          items:
            type: number
            format: double
          description: >-
            Smile parameter values, one corresponding by position to each
            benchmark maturity.
          nullable: true
        vols:
          type: array
          items:
            type: number
            format: double
          description: >-
            Volatility values expressed as decimals, where 0.20 means 20%, with
            one value corresponding by position to each benchmark maturity.
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.EquityVolSurfaceSvi,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Equity volatility surface carrying wing, skew, smile, and volatility
        parameter sequences.
    Dividends:
      required:
        - $type
      type: object
      properties:
        provider_id:
          type: string
          description: >-
            Market-data provider code recorded as the source of the
            contribution. Defaults to Derivitec.
          nullable: true
        derivitec_created:
          type: string
          description: Timestamp at which the market-data record was created.
        derivitec_modified:
          type: string
          description: Optional timestamp of the record's latest modification.
          nullable: true
        uploaded_date_time:
          type: string
          description: >-
            Optional timestamp at which the contribution was uploaded.
            UploadRateAssets ignores the supplied value on each rate asset and
            stores the current UTC time.
          nullable: true
        derivitec_modified_by:
          type: string
          description: >-
            Principal recorded as the latest modifier. UploadRateAssets ignores
            the supplied value on each rate asset and stores the authenticated
            user identifier.
          nullable: true
        uploaded_by:
          type: string
          description: >-
            Principal recorded as the uploader. UploadRateAssets ignores the
            supplied value on each rate asset and stores the authenticated user
            identifier.
          nullable: true
        rolled:
          type: boolean
          description: Whether the contribution has been rolled.
          example: false
        all_in_rates:
          type: array
          items:
            type: number
            format: double
          description: All-in rates aligned by index with ExDates.
          nullable: true
        asset_ids:
          type: array
          items:
            $ref: '#/components/schemas/InstrumentIdentifier'
          description: >-
            Asset identifiers aligned by index with ExDates; reconstruction
            supplies empty identifiers only when this collection is empty.
          nullable: true
        cash_divs:
          type: array
          items:
            type: number
            format: double
          description: Cash-dividend inputs aligned by index with ExDates.
          nullable: true
        confirmed_flags:
          type: array
          items:
            type: boolean
          description: Confirmation flags aligned by index with ExDates.
          nullable: true
        currencies:
          type: array
          items:
            type: string
          description: Currencies aligned by index with ExDates.
          nullable: true
        declared_dates:
          type: array
          items:
            type: string
            format: date-time
          description: Declaration dates aligned by index with ExDates.
          nullable: true
        div_types:
          type: array
          items:
            enum:
              - Regular
              - Extraordinary
              - Scrip
            type: string
            description: Classifies a dividend as regular, extraordinary, or scrip.
          description: Dividend classifications aligned by index with ExDates.
          nullable: true
        div_yields:
          type: array
          items:
            type: number
            format: double
          description: Dividend-yield inputs aligned by index with ExDates.
          nullable: true
        ex_dates:
          type: array
          items:
            type: string
            format: date-time
          description: >-
            Ex-dividend dates; their indexes define the rows reconstructed from
            the parallel collections.
          nullable: true
        pay_dates:
          type: array
          items:
            type: string
            format: date-time
          description: Payment dates aligned by index with ExDates.
          nullable: true
        record_dates:
          type: array
          items:
            type: string
            format: date-time
          description: Record dates aligned by index with ExDates.
          nullable: true
        withholding_tax_rates:
          type: array
          items:
            type: number
            format: double
          description: >-
            Withholding-tax rates aligned by index with ExDates; reconstruction
            supplies zero rates only when this collection is empty.
          nullable: true
        reference_date:
          type: string
          description: Date to which this projected-dividend set applies.
          format: date-time
        $type:
          type: string
          enum:
            - Derivitec.Web.Core.MarketData.Dividends, Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Columnar projected-dividend data whose per-dividend collections are
        consumed at matching indexes.
    Int32DoubleKeyValuePair:
      type: object
      properties:
        key:
          type: integer
          format: int32
        value:
          type: number
          format: double
      additionalProperties: false
    InstrumentIdentifierMintlifyShape:
      required:
        - $type
      type: object
      properties:
        code:
          type: string
          description: Instrument code interpreted in the selected identifier namespace.
          nullable: true
        identifier_type:
          enum:
            - Derivitec
            - Ric
            - Bloomberg
            - Isin
            - Figi
            - Sedol
            - RedCode
            - RedPairCode
            - BloombergYellow
            - XIgniteCode
            - CBondsId
            - EdiSecId
            - EdiSymbol
            - Cusip
            - NotSet
          type: string
          description: Namespace that determines how the instrument code is interpreted.
        market_identification_code:
          type: string
          description: >-
            Optional market identification code that further qualifies the
            instrument code.
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.InstrumentIdentifier,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Instrument code qualified by an identifier namespace and optional market
        code.
    InstrumentInfo:
      required:
        - $type
      type: object
      properties:
        code:
          type: string
          description: Instrument code interpreted in the selected identifier namespace.
          nullable: true
        identifier_type:
          enum:
            - Derivitec
            - Ric
            - Bloomberg
            - Isin
            - Figi
            - Sedol
            - RedCode
            - RedPairCode
            - BloombergYellow
            - XIgniteCode
            - CBondsId
            - EdiSecId
            - EdiSymbol
            - Cusip
            - NotSet
          type: string
          description: Namespace that determines how the instrument code is interpreted.
        market_identification_code:
          type: string
          description: >-
            Optional market identification code that further qualifies the
            instrument code.
          nullable: true
        name:
          type: string
          description: Human-readable name of the identified instrument.
          nullable: true
        $type:
          type: string
          enum:
            - Derivitec.Web.Core.MarketData.InstrumentInfo, Derivitec.Web.Core
      additionalProperties: false
      description: Instrument identifier with a human-readable instrument name.
  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

````