> ## 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 latest end of day US agency bond pricing data for a given set of ISINs.



## OpenAPI

````yaml post /api/v1/agency_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/agency_pricing_latest:
    post:
      tags: []
      summary: US agency latest end of day pricing data
      description: >-
        Get latest end of day US agency bond pricing data for a given set of
        ISINs.
      operationId: post_agency_pricing_latest
      parameters: []
      requestBody:
        content:
          application/json:
            example:
              as_of_date: '2026-04-01'
              isins:
                - US3135G05Q27
            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.


                    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:
                  - convexity: 1.13809
                    date: '2026-02-26'
                    duration: 4.35469
                    estimated_volume: 140000
                    id: 08iULjxKuBxsJl7kCIa5OQ
                    isin: US3135G05Q27
                    modified_duration: 4.20544
                    price: 89.23
                    yield_to_maturity: 3.5489
                total: 1
              schema:
                additionalProperties: false
                properties:
                  data:
                    description: List of response data objects, often capped to 1000.
                    items:
                      additionalProperties: false
                      properties:
                        convexity:
                          description: >-
                            Macaulay convexity, as calculated on `date` at
                            `price`.
                          nullable: true
                          type: number
                          x-struct: null
                          x-validate: null
                        date:
                          description: Trade date in ISO-8601 format (YYYY-MM-DD).
                          format: date
                          nullable: false
                          type: string
                          x-struct: null
                          x-validate: null
                        duration:
                          description: >-
                            Macaulay duration, as calculated on `date` at
                            `price`.
                          nullable: true
                          type: number
                          x-struct: null
                          x-validate: null
                        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
                        modified_duration:
                          description: >-
                            Modified duration, as calculated on `date` at
                            `price`.
                          nullable: true
                          type: number
                          x-struct: null
                          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
                        yield_to_maturity:
                          description: >-
                            Yield to maturity, as calculated on `date` at
                            `price`.
                          nullable: true
                          type: number
                          x-struct: null
                          x-validate: null
                      required:
                        - convexity
                        - date
                        - duration
                        - estimated_volume
                        - id
                        - isin
                        - modified_duration
                        - price
                        - yield_to_maturity
                      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: AgencyPricingLatestResponse
                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

````