Daily Historical Pricing

Bulk municipal historical pricing data for a given day.

curl --request POST \
  --url https://terrapinfinance.com/api/v1/muni_pricing_daily_history \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "trade_date": "2025-07-01"
}
'

{
  "data": [
    {
      "amount": 100000,
      "brokers_broker_trade_type": null,
      "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": "US38656NAD84",
      "price": 75.391,
      "settlement_date": "2025-07-01",
      "trade_datetime": "2025-07-01T00:00:00Z",
      "trade_type": "customer_bought",
      "ytc_continuous": 9.3783,
      "ytc_money_market": null,
      "ytc_semi_annual": 9.6017,
      "ytm_continuous": 5.77235,
      "ytm_money_market": null,
      "ytm_semi_annual": 5.8565
    },
    {
      "amount": 500000,
      "brokers_broker_trade_type": null,
      "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": "US05355ABT34",
      "price": 94.947,
      "settlement_date": "2025-07-01",
      "trade_datetime": "2025-07-01T00:00:00Z",
      "trade_type": "customer_bought",
      "ytc_continuous": 6.2244,
      "ytc_money_market": null,
      "ytc_semi_annual": 6.3223,
      "ytm_continuous": 5.782,
      "ytm_money_market": null,
      "ytm_semi_annual": 5.8664
    }
  ],
  "total": 2
}

POST

api

muni_pricing_daily_history

Bulk municipal historical pricing data for a given day.

curl --request POST \
  --url https://terrapinfinance.com/api/v1/muni_pricing_daily_history \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "trade_date": "2025-07-01"
}
'

{
  "data": [
    {
      "amount": 100000,
      "brokers_broker_trade_type": null,
      "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": "US38656NAD84",
      "price": 75.391,
      "settlement_date": "2025-07-01",
      "trade_datetime": "2025-07-01T00:00:00Z",
      "trade_type": "customer_bought",
      "ytc_continuous": 9.3783,
      "ytc_money_market": null,
      "ytc_semi_annual": 9.6017,
      "ytm_continuous": 5.77235,
      "ytm_money_market": null,
      "ytm_semi_annual": 5.8565
    },
    {
      "amount": 500000,
      "brokers_broker_trade_type": null,
      "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": "US05355ABT34",
      "price": 94.947,
      "settlement_date": "2025-07-01",
      "trade_datetime": "2025-07-01T00:00:00Z",
      "trade_type": "customer_bought",
      "ytc_continuous": 6.2244,
      "ytc_money_market": null,
      "ytc_semi_annual": 6.3223,
      "ytm_continuous": 5.782,
      "ytm_money_market": null,
      "ytm_semi_annual": 5.8664
    }
  ],
  "total": 2
}

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

trade_date

string<date>

required

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

Response

A list of all US municipal bond trades and pricing data for the specified date.

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.

Historical Pricing Price To Yield

⌘I

Overview

Government and corporate bonds

US municipal bonds

Daily Historical Pricing

Authorizations

Headers

Body

Response