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



## OpenAPI

````yaml post /api/v1/muni_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/muni_pricing_latest:
    post:
      tags: []
      summary: Municipal latest end of day pricing data
      description: >-
        Get the latest end of day US municipal bond pricing data for a given set
        of ISINs.
      operationId: post_muni_pricing_latest
      parameters: []
      requestBody:
        content:
          application/json:
            example:
              as_of_date: '2025-08-11'
              isins:
                - US828641ZF03
            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: US64966HW301
                    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:
                  - amount: 10000
                    id: pPwoatVrqhKC8LdABwjqiQ
                    is_alt_trading_system: false
                    is_cancelled: false
                    is_list_offering_price: false
                    is_non_transaction_compensation: false
                    is_weighted_avg_price_trade: false
                    is_when_issued_trade: false
                    isin: US828641ZF03
                    price: 103.835
                    settlement_date: '2025-08-05'
                    trade_datetime: '2025-08-04T18:48:08'
                    trade_type: customer_bought
                    ytc_continuous: 4.4593
                    ytc_money_market: null
                    ytc_semi_annual: 4.5094
                    ytm_continuous: 4.92084
                    ytm_money_market: null
                    ytm_semi_annual: 4.9819
                total: 1
              schema:
                additionalProperties: false
                properties:
                  data:
                    description: List of response data objects, often capped to 1000.
                    items:
                      additionalProperties: false
                      properties:
                        amount:
                          description: >
                            Amount of the trade, the total face value
                            (principal) of bonds traded in this transaction.
                          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
                        is_alt_trading_system:
                          description: >
                            Whether this is an alternative trading system (ATS)
                            trade. An ATS is a non-exchange trading venue that
                            matches buyers and sellers of securities.
                          nullable: false
                          type: boolean
                          x-struct: null
                          x-validate: null
                        is_cancelled:
                          description: Whether the trade has been cancelled.
                          nullable: false
                          type: boolean
                          x-struct: null
                          x-validate: null
                        is_list_offering_price:
                          description: >
                            Whether this is a list offering price, which is a
                            price that is set by the issuer (primary market) and
                            is used to determine the price of the bond in the
                            secondary market.
                          nullable: false
                          type: boolean
                          x-struct: null
                          x-validate: null
                        is_non_transaction_compensation:
                          description: >
                            Whether this is a non-transaction compensation
                            trade, which is a trade that is reported for
                            regulatory or compensation purposes, but does not
                            represent an actual transaction between a buyer and
                            seller.
                          nullable: false
                          type: boolean
                          x-struct: null
                          x-validate: null
                        is_weighted_avg_price_trade:
                          description: >
                            Whether this is a weighted average price trade,
                            which is a trade that is executed at the weighted
                            average price of multiple executions at different
                            prices, typically when a dealer fills an order in
                            pieces.


                            Weighted average price trades aggregate several
                            executions into one reported trade at the average
                            price.
                          nullable: false
                          type: boolean
                          x-struct: null
                          x-validate: null
                        is_when_issued_trade:
                          description: >
                            Whether this is a when-issued trade, which is a
                            trade that is executed before the official issuance
                            and delivery of the bond.
                          nullable: false
                          type: boolean
                          x-struct: null
                          x-validate: null
                        isin:
                          description: >-
                            International Securities Identification Number
                            (ISIN), unique 12-character code for the security.
                          example: US64966HW301
                          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: >
                            Trade price of the municipal bond, expressed as a
                            percentage of the bond's face value.
                          nullable: false
                          type: number
                          x-struct: null
                          x-validate: null
                        settlement_date:
                          description: Settlement date in ISO-8601 format (YYYY-MM-DD).
                          format: date
                          nullable: false
                          type: string
                          x-struct: null
                          x-validate: null
                        trade_datetime:
                          description: >-
                            Trade datetime in ISO-8601 format
                            (YYYY-MM-DDTHH:MM:SS).
                          format: date_time
                          nullable: false
                          type: string
                          x-struct: null
                          x-validate: null
                        trade_type:
                          description: |
                            Type of trade:

                            - `customer_bought`: Customer bought from a dealer
                            - `customer_sold`: Customer sold to a dealer
                            - `inter_dealer`: Trade between dealers
                          enum:
                            - customer_bought
                            - customer_sold
                            - inter_dealer
                          nullable: true
                          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:
                        - amount
                        - id
                        - is_alt_trading_system
                        - is_cancelled
                        - is_list_offering_price
                        - is_non_transaction_compensation
                        - is_weighted_avg_price_trade
                        - is_when_issued_trade
                        - isin
                        - price
                        - settlement_date
                        - trade_datetime
                        - trade_type
                        - 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: MuniPricingLatestResponse
                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

````