> ## 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 a discount curve for display.

> Use this operation for the selected currency's yield-curve model. `MarketDate` is optional; omitting it
uses the latest available market-data date. Supported minor-unit currency aliases are normalised to their
major currency for the returned curve. One authorised provider/environment selector form determines the
requested curve; a shared-provider-only request can include fitting-instrument display details. It is read-only and synchronous.



## OpenAPI

````yaml /risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json post /api/RateAsset
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/RateAsset:
    post:
      tags:
        - RateAsset
      summary: Retrieve a discount curve for display.
      description: >-
        Use this operation for the selected currency's yield-curve model.
        `MarketDate` is optional; omitting it

        uses the latest available market-data date. Supported minor-unit
        currency aliases are normalised to their

        major currency for the returned curve. One authorised
        provider/environment selector form determines the

        requested curve; a shared-provider-only request can include
        fitting-instrument display details. It is read-only and synchronous.
      operationId: DisplayRateCurve
      requestBody:
        description: >-
          A non-empty currency code, optional ISO 8601 `MarketDate`, and one
          authorised provider-selector form.
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/ApiGetDiscountCurveMktDataRequest'
          application/json:
            schema:
              $ref: '#/components/schemas/ApiGetDiscountCurveMktDataRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/ApiGetDiscountCurveMktDataRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/ApiGetDiscountCurveMktDataRequest'
      responses:
        '200':
          description: >-
            Returns the curve currency, effective and latest market dates, and
            yield-curve points.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiGetDiscountCurveMktDataResponse'
        '400':
          description: BadRequest
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
        - oauth2: []
        - apikey: []
components:
  schemas:
    ApiGetDiscountCurveMktDataRequest:
      required:
        - $type
      type: object
      properties:
        provider_id:
          type: string
          description: >-
            Opaque identifier of a single market-data provider to use instead of
            either environment-name option.
          nullable: true
        entity_access_type:
          enum:
            - view
            - edit
            - owner
            - blocked
          type: string
          description: >-
            Access classification associated with the selected market-data
            environment.
        market_data_environment_names:
          type: array
          items:
            type: string
          description: >-
            Names of the market-data environments to use. Do not combine this
            list with the single-name or provider-ID alternatives.
          nullable: true
        market_data_environment_name:
          type: string
          description: >-
            Single market-data environment name to use instead of
            `market_data_environment_names` or `provider_id`.
          nullable: true
          example: Example market data
        currency:
          type: string
          description: Currency that narrows the discount curve market operation.
          nullable: true
        market_date:
          type: string
          description: Market date represented by the rate-curve display.
          format: date-time
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.ApiGetDiscountCurveMktDataRequest,
              Derivitec.Web.Core
      additionalProperties: false
      description: Selects the currency and market date for a rate-curve display.
    ApiGetDiscountCurveMktDataResponse:
      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
        provider_id:
          type: string
          description: >-
            Opaque identifier of the market-data provider associated with the
            returned data.
          nullable: true
        yield_curve_model:
          $ref: '#/components/schemas/YieldCurveModel'
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.MarketData.ApiGetDiscountCurveMktDataResponse,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Returns the rate-curve display for the selected currency and market
        date.
    YieldCurveModel:
      required:
        - $type
      type: object
      properties:
        currency:
          type: string
          description: Currency code of the displayed yield curve.
          nullable: true
        data:
          type: array
          items:
            $ref: '#/components/schemas/YieldCurvePoint'
          description: Yield-curve points returned for the selected market date.
          nullable: true
        latest_market_date:
          type: string
          description: >-
            Latest general market-data date reported by the service; not an
            availability date specific to this curve.
          format: date-time
        market_date:
          type: string
          description: Market date represented by the displayed curve.
          format: date-time
        $type:
          type: string
          enum:
            - Derivitec.Web.Core.MarketData.YieldCurveModel, Derivitec.Web.Core
      additionalProperties: false
      description: >-
        Display-ready yield-curve points and market-date context for one
        currency.
    YieldCurvePoint:
      required:
        - $type
      type: object
      properties:
        expiry:
          type: string
          description: Expiry date obtained from the curve's market date and maturity.
          format: date-time
        maturity:
          type: integer
          description: Calendar days after the curve market date.
          format: int32
        rate:
          type: number
          description: Zero rate as a decimal; 0.05 means 5%.
          format: double
        fitted_instrument_name:
          type: string
          description: Optional display name of the instrument fitted at this point.
          nullable: true
        fitted_instrument_rate:
          type: number
          description: >-
            Optional fitted-instrument quote in percentage points reported at
            this point.
          format: double
          nullable: true
        $type:
          type: string
          enum:
            - Derivitec.Web.Core.MarketData.YieldCurvePoint, Derivitec.Web.Core
      additionalProperties: false
      description: >-
        One dated yield-curve point with maturity, rate, and optional
        fitted-instrument details.
  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

````