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

# Latest Pricing

> Get the latest end of day corporate and US agency bond pricing data for a given set of ISINs.

<Warning>
  This endpoint is in **preview** and not yet fully production-ready. Its fields, behavior, and availability may change without notice.
</Warning>


## OpenAPI

````yaml post /api/v1/securities_pricing_latest
openapi: 3.0.0
info:
  title: Terrapin API
  version: 1.0.0
servers:
  - url: https://terrapinfinance.com
    variables: {}
security:
  - authorization: []
tags: []
paths:
  /api/v1/securities_pricing_latest:
    post:
      tags: []
      summary: Corporate and US agency latest end of day pricing data
      description: >-
        Get the latest end of day corporate and US agency bond pricing data for
        a given set of ISINs.
      operationId: post_securities_pricing_latest
      parameters: []
      requestBody:
        content:
          application/json:
            example:
              as_of_date: '2026-05-12'
              isins:
                - US3133ETE294
                - US875127BL56
            schema:
              additionalProperties: false
              properties:
                as_of_date:
                  description: >
                    Set this date (in ISO-8601 format (YYYY-MM-DD)) to get the
                    latest pricing data as of a specific date.


                    The cut-off is `as_of_date` 23:59:59 UTC, matched against
                    the UTC `trade_datetime`.


                    When not set, the latest pricing data is returned.
                  format: date
                  type: string
                  x-struct: null
                  x-validate: null
                isins:
                  description: >-
                    International Securities Identification Number (ISIN),
                    unique 12-character code for the security.
                  items:
                    example: CH0282526133
                    maxLength: 12
                    minLength: 12
                    nullable: false
                    type: string
                    x-struct: null
                    x-validate: null
                  type: array
                  x-check: valid_check_digit
                  x-check-error: Invalid ISIN check digit
                  x-struct: null
                  x-transform: upcase
                  x-validate: null
              required:
                - isins
              type: object
              x-struct: null
              x-validate: null
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
                data:
                  - estimated_volume: 4000
                    id: 6sBsIYX3FzkW7qo2H4gaJw
                    isin: US3133ETE294
                    price: 98.728542
                    trade_datetime: '2026-05-12T22:32:21'
                    ytc_continuous: 19.5888
                    ytc_money_market: 19.7442
                    ytc_semi_annual: null
                    ytm_continuous: 6.882
                    ytm_money_market: 6.9789
                    ytm_semi_annual: null
                  - estimated_volume: 700000
                    id: UW3ga5-KjlIfTI6o3wxgOw
                    isin: US875127BL56
                    price: 89.743
                    trade_datetime: '2026-05-12T00:00:01'
                    ytc_continuous: 5.6885
                    ytc_money_market: null
                    ytc_semi_annual: 5.7701
                    ytm_continuous: 5.6817
                    ytm_money_market: null
                    ytm_semi_annual: 5.7631
                total: 2
              schema:
                additionalProperties: false
                properties:
                  data:
                    description: List of response data objects, often capped to 1000.
                    items:
                      additionalProperties: false
                      properties:
                        estimated_volume:
                          description: >-
                            Estimated notional traded volume of the bond at
                            `date`. This value will necessarily be an
                            underestimation of the actual traded volume due to
                            the lack of complete reported trades.
                          nullable: true
                          type: number
                          x-struct: null
                          x-validate: null
                        id:
                          description: Unique trade identifier.
                          nullable: false
                          type: string
                          x-struct: null
                          x-validate: null
                        isin:
                          description: >-
                            International Securities Identification Number
                            (ISIN), unique 12-character code for the security.
                          example: CH0282526133
                          maxLength: 12
                          minLength: 12
                          nullable: false
                          type: string
                          x-check: valid_check_digit
                          x-check-error: Invalid ISIN check digit
                          x-struct: null
                          x-transform: upcase
                          x-validate: null
                        price:
                          description: >
                            Price of the bond at last trade of the day,
                            expressed as a percentage of the bond's face value.
                          nullable: false
                          type: number
                          x-struct: null
                          x-validate: null
                        trade_datetime:
                          description: >-
                            Trade datetime in UTC, in ISO-8601 format
                            (YYYY-MM-DDTHH:MM:SS)
                          format: date_time
                          nullable: false
                          type: string
                          x-struct: null
                          x-validate: null
                        ytc_continuous:
                          description: Yield to call (continuous compounding).
                          nullable: true
                          type: number
                          x-struct: null
                          x-validate: null
                        ytc_money_market:
                          description: Yield to call (money market convention).
                          nullable: true
                          type: number
                          x-struct: null
                          x-validate: null
                        ytc_semi_annual:
                          description: Yield to call (semi-annual convention).
                          nullable: true
                          type: number
                          x-struct: null
                          x-validate: null
                        ytm_continuous:
                          description: Yield to maturity (continuous compounding).
                          nullable: true
                          type: number
                          x-struct: null
                          x-validate: null
                        ytm_money_market:
                          description: Yield to maturity (money market convention).
                          nullable: true
                          type: number
                          x-struct: null
                          x-validate: null
                        ytm_semi_annual:
                          description: Yield to maturity (semi-annual convention).
                          nullable: true
                          type: number
                          x-struct: null
                          x-validate: null
                      required:
                        - estimated_volume
                        - id
                        - isin
                        - price
                        - trade_datetime
                        - ytc_continuous
                        - ytc_money_market
                        - ytc_semi_annual
                        - ytm_continuous
                        - ytm_money_market
                        - ytm_semi_annual
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                  total:
                    description: >-
                      Total number of results in the database that match the
                      query filters.
                    type: integer
                    x-struct: null
                    x-validate: null
                required:
                  - data
                  - total
                title: SecuritiesPricingLatestResponse
                type: object
                x-struct: null
                x-validate: null
          description: Latest end of day pricing data
        '401':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Unauthorized
                          type: string
                          x-struct: null
                          x-validate: null
                        reason:
                          example: >-
                            Your account tier does not allow this operation.
                            Contact team@terrapinfinance.com for an upgrade.
                          type: string
                          x-struct: null
                          x-validate: null
                      required:
                        - detail
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                required:
                  - errors
                type: object
                x-struct: null
                x-validate: null
          description: Unauthorized
        '402':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Payment Required
                          type: string
                          x-struct: null
                          x-validate: null
                        reason:
                          example: >-
                            You have run out of your granted quota for this
                            resource as defined by your account tier. Contact
                            team@terrapinfinance.com for an upgrade.
                          type: string
                          x-struct: null
                          x-validate: null
                      required:
                        - detail
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                required:
                  - errors
                type: object
                x-struct: null
                x-validate: null
          description: Payment Required
        '403':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Forbidden
                          type: string
                          x-struct: null
                          x-validate: null
                        reason:
                          example: >-
                            Your account tier does not allow this operation.
                            Contact team@terrapinfinance.com for an upgrade.
                          type: string
                          x-struct: null
                          x-validate: null
                      required:
                        - detail
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                required:
                  - errors
                type: object
                x-struct: null
                x-validate: null
          description: Forbidden
        '422':
          content:
            application/json:
              schema:
                properties:
                  errors:
                    items:
                      properties:
                        detail:
                          example: 'Invalid string. Got: integer'
                          type: string
                          x-struct: null
                          x-validate: null
                        source:
                          properties:
                            pointer:
                              example: /isins/0
                              type: string
                              x-struct: null
                              x-validate: null
                          required:
                            - pointer
                          type: object
                          x-struct: null
                          x-validate: null
                        title:
                          example: Invalid value
                          type: string
                          x-struct: null
                          x-validate: null
                      required:
                        - detail
                        - source
                        - title
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                required:
                  - errors
                type: object
                x-struct: null
                x-validate: null
          description: Unprocessable Entity
        '429':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Too Many Requests
                          type: string
                          x-struct: null
                          x-validate: null
                        reason:
                          type: string
                          x-struct: null
                          x-validate: null
                      required:
                        - detail
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                required:
                  - errors
                type: object
                x-struct: null
                x-validate: null
          description: Too Many Requests
        '500':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Internal Server Error
                          type: string
                          x-struct: null
                          x-validate: null
                        reason:
                          type: string
                          x-struct: null
                          x-validate: null
                      required:
                        - detail
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                required:
                  - errors
                type: object
                x-struct: null
                x-validate: null
          description: Internal Server Error
      callbacks: {}
components:
  securitySchemes:
    authorization:
      scheme: bearer
      type: http

````