Latest Pricing

Municipal latest pricing data

curl --request POST \
  --url https://terrapinfinance.com/api/v1/muni_pricing_latest \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "as_of_date": "2025-08-11",
  "isins": [
    "US828641ZF03"
  ]
}
'

{
  "data": [
    {
      "amount": 10000,
      "is_alt_trading_system": 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
}

POST

api

muni_pricing_latest

Municipal latest pricing data

curl --request POST \
  --url https://terrapinfinance.com/api/v1/muni_pricing_latest \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "as_of_date": "2025-08-11",
  "isins": [
    "US828641ZF03"
  ]
}
'

{
  "data": [
    {
      "amount": 10000,
      "is_alt_trading_system": 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
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

enum<string>

default:application/json

required

Specify text/csv if you would like to receive a CSV file.

Available options:

application/json,

text/csv

Body

application/json

isins

string[]

required

International Securities Identification Number (ISIN), unique 12-character code for the security.

Required string length: 12

as_of_date

string<date>

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.

Response

Latest pricing data

data

object[]

required

List of response data objects, often capped to 1000.

Show child attributes

data.amount

number | null

required

Amount of the trade, the total face value (principal) of bonds traded in this transaction.

data.is_alt_trading_system

boolean

required

Whether this is an alternative trading system (ATS) trade. An ATS is a non-exchange trading venue that matches buyers and sellers of securities.

data.is_list_offering_price

boolean

required

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.

data.is_non_transaction_compensation

boolean

required

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.

data.is_weighted_avg_price_trade

boolean

required

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.

data.is_when_issued_trade

boolean

required

Whether this is a when-issued trade, which is a trade that is executed before the official issuance and delivery of the bond.

data.isin

string

required

International Securities Identification Number (ISIN), unique 12-character code for the security.

Required string length: 12

Example:

"US64966HW301"

data.price

number

required

Trade price of the municipal bond, expressed as a percentage of the bond's face value.

data.settlement_date

string<date>

required

Settlement date in ISO-8601 format (YYYY-MM-DD).

data.trade_datetime

string<date_time>

required

Trade datetime in ISO-8601 format (YYYY-MM-DDTHH:MM:SS).

data.trade_type

enum<string> | null

required

Type of trade:

customer_bought: Customer bought from a dealer
customer_sold: Customer sold to a dealer
inter_dealer: Trade between dealers

Available options:

customer_bought,

customer_sold,

inter_dealer

data.ytc_continuous

number | null

required

Yield to call (continuous compounding).

data.ytc_money_market

number | null

required

Yield to call (money market convention).

data.ytc_semi_annual

number | null

required

Yield to call (semi-annual convention).

data.ytm_continuous

number | null

required

Yield to maturity (continuous compounding).

data.ytm_money_market

number | null

required

Yield to maturity (money market convention).

data.ytm_semi_annual

number | null

required

Yield to maturity (semi-annual convention).

total

integer

required

Total number of results in the database that match the query filters.

Reference Data Historical Pricing

⌘I

Overview

Government and corporate bonds

US municipal bonds

Authorizations

Headers

Body

Response