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

# List bond futures markets and the contracts they currently list.

> Returns every covered bond futures market with its Reuters and Bloomberg code prefixes and the contracts listed as of today, earliest expiry first and never including one that has already expired. A contract whose generated code would name a different delivery year than its own expiry is omitted, because booking takes the maturity from the code. Listings depend on the current date, so the result is not stable across days. This synchronous operation is read-only.



## OpenAPI

````yaml /risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json get /api/Bond/BondFutureOptions
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/Bond/BondFutureOptions:
    get:
      tags:
        - Bond
      summary: List bond futures markets and the contracts they currently list.
      description: >-
        Returns every covered bond futures market with its Reuters and Bloomberg
        code prefixes and the contracts listed as of today, earliest expiry
        first and never including one that has already expired. A contract whose
        generated code would name a different delivery year than its own expiry
        is omitted, because booking takes the maturity from the code. Listings
        depend on the current date, so the result is not stable across days.
        This synchronous operation is read-only.
      operationId: BondFutureOptions
      responses:
        '200':
          description: >-
            Returns the bond futures markets with `IsSuccess = true`, or
            `IsSuccess = false` with the reason reference data could not be
            read.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiGetBondFutureOptionsResponse'
        '400':
          description: BadRequest
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
        - oauth2: []
        - apikey: []
components:
  schemas:
    ApiGetBondFutureOptionsResponse:
      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
        bond_future_markets:
          type: array
          items:
            $ref: '#/components/schemas/BondFutureMarketOption'
          description: >-
            Every bond futures market covered by reference data, ordered by
            name. Empty when reference

            data lists none, or when the request failed.
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.TradeBooking.ApiGetBondFutureOptionsResponse,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        The bond futures markets available to trade booking, used to populate
        the contract selector for

        bond futures.
    BondFutureMarketOption:
      required:
        - $type
      type: object
      properties:
        futures_market_id:
          type: string
          description: >-
            Identifies this futures market within Derivitec reference data.
            Stable across requests and

            used to keep a selection pointing at the same market.
          nullable: true
        display_name:
          type: string
          description: >-
            The market's name as traders know it, used as the label in the
            selector.
          nullable: true
          example: Euro-Bund
        bloomberg_prefix:
          type: string
          description: >-
            The prefix Bloomberg codes for this market start with. Empty when
            the market has no

            Bloomberg coverage.
          nullable: true
          example: RX
        reuters_prefix:
          type: string
          description: >-
            The prefix Reuters codes for this market start with, used to
            recognise which market a

            futures code already on a position belongs to. Empty when the market
            has no Reuters coverage.
          nullable: true
          example: FGBL
        listed_contracts:
          type: array
          items:
            $ref: '#/components/schemas/BondFutureContractOption'
          description: >-
            The contracts this market lists as of today, earliest expiry first
            and never including one

            that has already expired. Empty when the market lists nothing
            bookable.
          nullable: true
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.TradeBooking.BondFutureMarketOption,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        A bond futures market a trade can be booked against, together with the
        contracts it currently

        lists. Choosing one fills in the futures code so that a deliverable
        contract cannot be typed by

        hand.
    BondFutureContractOption:
      required:
        - $type
      type: object
      properties:
        futures_code:
          type: string
          description: Canonical Reuters code persisted on the import-compatible contract.
          nullable: true
        display_code:
          type: string
          description: Bloomberg code displayed by the legacy edit page.
          nullable: true
        expiration_date:
          type: string
          description: >-
            The date this contract expires, as a UTC calendar date with no
            meaningful time of day.
          format: date-time
          example: '2026-12-08T00:00:00Z'
        $type:
          type: string
          enum:
            - >-
              Derivitec.Web.Core.TradeBooking.BondFutureContractOption,
              Derivitec.Web.Core
      additionalProperties: false
      description: >-
        One listed bond futures contract a trade can be booked against, as
        offered by a bond futures

        market's expiry selector.
  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

````