> ## Documentation Index
> Fetch the complete documentation index at: https://docs.engine.usesophic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List on-the-run bills

> Returns the on-the-run treasury bill for each standard maturity period of the given issuer country that currently has a matching bill. Periods with no matching bill are omitted from the response.



## OpenAPI

````yaml https://api.engine.usesophic.com/openapi.json get /bills/otr
openapi: 3.1.0
info:
  title: Sophic Engine API
  version: 0.1.0
servers:
  - url: https://api.engine.usesophic.com/
security: []
paths:
  /bills/otr:
    get:
      summary: List on-the-run bills
      description: >-
        Returns the on-the-run treasury bill for each standard maturity period
        of the given issuer country that currently has a matching bill. Periods
        with no matching bill are omitted from the response.
      operationId: get_on_the_run_bill_matrix_bills_otr_get
      parameters:
        - name: issuer_country
          in: query
          required: true
          schema:
            type: string
            title: Issuer Country
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  $ref: '#/components/schemas/Bill'
                title: Response Get On The Run Bill Matrix Bills Otr Get
              examples:
                default:
                  summary: EU on-the-run matrix with no 6m match
                  value:
                    3m:
                      id: instrument_abc123
                      name: EU 3M T-Bill 2024-01-04
                      symbol: EU0000000001
                      instrument_type: bill
                      isin: EU0000000001
                      issuer: EU
                      issuer_country: EU
                      trading_currency: EUR
                      maturity_date: '2024-01-04'
                      days_to_maturity: 92
                    12m:
                      id: instrument_def456
                      name: EU 12M T-Bill 2024-10-04
                      symbol: EU0000000011
                      instrument_type: bill
                      isin: EU0000000011
                      issuer: EU
                      issuer_country: EU
                      trading_currency: EUR
                      maturity_date: '2024-10-04'
                      days_to_maturity: 366
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - HTTPBearer: []
components:
  schemas:
    Bill:
      properties:
        id:
          type: string
          title: Id
          description: Unique resource identifier.
        name:
          type: string
          title: Name
          description: The name of the instrument.
        symbol:
          type: string
          title: Symbol
          description: >-
            A unique, secondary, identifier representing the instrument in
            financial markets (e.g. ISIN or currency pair). For example,
            'US5949181045' for the Apple Inc. stock and 'EUR/USD' for the
            EUR/USD currency pair. 
        instrument_type:
          const: bill
          title: Instrument Type
          description: The type of instrument.
        trading_status:
          allOf:
            - $ref: '#/components/schemas/InstrumentTradingStatus'
          description: The trading status of the instrument.
        rollout_stage:
          anyOf:
            - $ref: '#/components/schemas/InstrumentRolloutStage'
            - type: 'null'
          description: >-
            The rollout stage of the instrument. GA instruments are visible to
            every user; BETA instruments are visible only to pilot users.
        trading_increment:
          type: string
          title: Trading Increment
          description: >-
            The trading increment refers to the smallest quantity or value of a
            financial instrument that can be traded. This means orders must be
            executed in multiples of this increment.
        decimal_precision:
          type: integer
          title: Decimal Precision
          description: >-
            The number of decimal places for this instrument's trading
            increment.
        pro_traders_only:
          type: boolean
          title: Pro Traders Only
          description: >-
            Flag indicating if this instrument is only available to professional
            (incl. elective) investors under MiFID II.
        price_type:
          allOf:
            - $ref: '#/components/schemas/PriceType'
          description: The type of price for this instrument.
        isin:
          type: string
          title: Isin
          description: International Securities Identification Number.
        ticker:
          anyOf:
            - type: string
            - type: 'null'
          title: Ticker
          description: The ticker symbol of the security.
        issuer:
          type: string
          title: Issuer
          description: The name of the instrument issuer.
        issuer_country:
          anyOf:
            - type: string
            - type: 'null'
          title: Issuer Country
          description: >-
            The country code (in [ISO 3166-1
            alpha-2](https://www.iso.org/iso-3166-country-codes.html) format) of
            the instrument issuer.
        minimum_trading_quantity:
          type: string
          title: Minimum Trading Quantity
          description: >-
            The minimum trading quantity allowed for the given financial
            instrument.
        trading_currency:
          allOf:
            - $ref: '#/components/schemas/Currency'
          description: The instrument's trading currency.
        initial_issue_date:
          type: string
          format: date
          title: Initial Issue Date
          description: >-
            The initial issue date ([ISO
            8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of
            the instrument.
        enforce_trading_rules:
          type: boolean
          title: Enforce Trading Rules
        minimum_initial_cash_investment:
          type: string
          title: Minimum Initial Cash Investment
        required_cash_increment:
          type: integer
          title: Required Cash Increment
        maturity_date:
          type: string
          format: date
          title: Maturity Date
          description: The maturity date of the instrument.
        days_to_maturity:
          type: integer
          title: Days To Maturity
          description: The number of days until the instrument matures.
        supports_automatic_rollover:
          type: boolean
          title: Supports Automatic Rollover
          description: >-
            Flag indicating whether account positions in this instrument can be
            configured to automatically rollover upon maturity.
        issuer_credit_rating:
          type: string
          title: Issuer Credit Rating
          description: Credit rating from a credit agency e.g AA.
        initial_auction_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Initial Auction Date
          description: >-
            The initial auction date ([ISO
            8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of
            the instrument.
        latest_auction_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Latest Auction Date
          description: >-
            The latest auction date ([ISO
            8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of
            the instrument (in case of tap issues).
        latest_issue_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Latest Issue Date
          description: >-
            The latest issue date ([ISO
            8601](https://www.iso.org/iso-8601-date-and-time-format.html)) of
            the instrument (in case of tap issues).
        par_value:
          anyOf:
            - type: string
            - type: 'null'
          title: Par Value
          description: >-
            Nominal denomination per unit against which the price is quoted, as
            reported by the venue. Varies by market convention: many Euro MTNs
            quote 1.00, US Treasuries typically 100, and US corporates often 100
            or 1000. Stored for reference only.
      type: object
      required:
        - id
        - name
        - symbol
        - instrument_type
        - trading_status
        - rollout_stage
        - trading_increment
        - decimal_precision
        - pro_traders_only
        - price_type
        - isin
        - issuer_country
        - minimum_trading_quantity
        - trading_currency
        - initial_issue_date
        - enforce_trading_rules
        - minimum_initial_cash_investment
        - required_cash_increment
        - maturity_date
        - days_to_maturity
        - supports_automatic_rollover
        - issuer_credit_rating
        - initial_auction_date
        - latest_auction_date
        - latest_issue_date
        - par_value
      title: Bill
    Error:
      properties:
        detail:
          type: string
          title: Detail
          description: A human-readable description of the error.
        code:
          type: string
          title: Code
          description: A machine-readable error code.
        docs:
          title: Docs
          description: A URL to documentation about this error code.
          x-remove-null-from-type-union: true
          type: string
        context:
          title: Context
          description: An optional object for adding extra context to the error.
          x-remove-null-from-type-union: true
          additionalProperties:
            anyOf:
              - type: string
              - type: integer
          type: object
        params:
          title: Params
          description: An optional list of params that failed validation.
          x-remove-null-from-type-union: true
          items:
            $ref: '#/components/schemas/InvalidParam'
          type: array
      type: object
      required:
        - detail
        - code
      title: Error
    InstrumentTradingStatus:
      type: string
      enum:
        - buy_sell
        - buy_only
        - sell_only
        - not_trading
      title: InstrumentTradingStatus
      properties: {}
    InstrumentRolloutStage:
      type: string
      enum:
        - ga
        - beta
      title: InstrumentRolloutStage
      properties: {}
    PriceType:
      type: string
      enum:
        - percent
        - money
      title: PriceType
      properties: {}
    Currency:
      type: string
      enum:
        - EUR
        - USD
        - GBP
      title: Currency
      properties: {}
    InvalidParam:
      properties:
        path:
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
          title: Path
          description: Path to the field name (or index if a list) that errored.
        detail:
          type: string
          title: Detail
          description: Human-readable detail for error.
        code:
          type: string
          title: Code
          description: A machine-readable error code.
      type: object
      required:
        - path
        - detail
        - code
      title: InvalidParam
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````