Historical Pricing

Municipal historical pricing data

curl --request POST \
  --url https://terrapinfinance.com/api/v1/muni_pricing_history \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "end_date": "2025-03-01",
  "isin": "US1966324Q32",
  "start_date": "2025-02-01"
}
'

{
  "data": [
    {
      "amount": 15000,
      "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": "US1966324Q32",
      "price": 113.45,
      "settlement_date": "2025-02-24",
      "trade_datetime": "2025-02-21T19:10:48",
      "trade_type": "inter_dealer",
      "ytc_continuous": 3.1926,
      "ytc_money_market": null,
      "ytc_semi_annual": 3.2182,
      "ytm_continuous": 3.55388,
      "ytm_money_market": null,
      "ytm_semi_annual": 3.5856
    },
    {
      "amount": 15000,
      "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": "US1966324Q32",
      "price": 113.45,
      "settlement_date": "2025-02-24",
      "trade_datetime": "2025-02-21T19:10:48",
      "trade_type": "customer_sold",
      "ytc_continuous": 3.1926,
      "ytc_money_market": null,
      "ytc_semi_annual": 3.2182,
      "ytm_continuous": 3.55388,
      "ytm_money_market": null,
      "ytm_semi_annual": 3.5856
    }
  ],
  "total": 2
}

POST

api

muni_pricing_history

Municipal historical pricing data

curl --request POST \
  --url https://terrapinfinance.com/api/v1/muni_pricing_history \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "end_date": "2025-03-01",
  "isin": "US1966324Q32",
  "start_date": "2025-02-01"
}
'

{
  "data": [
    {
      "amount": 15000,
      "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": "US1966324Q32",
      "price": 113.45,
      "settlement_date": "2025-02-24",
      "trade_datetime": "2025-02-21T19:10:48",
      "trade_type": "inter_dealer",
      "ytc_continuous": 3.1926,
      "ytc_money_market": null,
      "ytc_semi_annual": 3.2182,
      "ytm_continuous": 3.55388,
      "ytm_money_market": null,
      "ytm_semi_annual": 3.5856
    },
    {
      "amount": 15000,
      "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": "US1966324Q32",
      "price": 113.45,
      "settlement_date": "2025-02-24",
      "trade_datetime": "2025-02-21T19:10:48",
      "trade_type": "customer_sold",
      "ytc_continuous": 3.1926,
      "ytc_money_market": null,
      "ytc_semi_annual": 3.2182,
      "ytm_continuous": 3.55388,
      "ytm_money_market": null,
      "ytm_semi_annual": 3.5856
    }
  ],
  "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

end_date

string<date>

required

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

isin

string

required

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

Required string length: 12

start_date

string<date>

required

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

Response

Pricing history 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.

Latest Pricing Daily Historical Pricing

⌘I

Overview

Government and corporate bonds

US municipal bonds

Historical Pricing

Authorizations

Headers

Body

Response