Skip to main content
Terrapin is a modern fixed-income data company, providing access to reference and pricing data, as well as official statements and disclosure documents.

​
Coverage

The /api/v1/bond_* (~35,000 global government & corporate bonds) endpoints are deprecated. These endpoints will be maintained and available until February 1, 2027. The /api/v1/agency_* (~70,000 US agency bonds) endpoints are soon to be deprecated. Prefer /api/v1/securities_*; it will soon serve US agency data as well.

​
How endpoints are named

Endpoints follow a {universe}_{data_type} convention (securities, muni, the deprecated bond prefix, and the soon-to-be-deprecated agency prefix). Each universe exposes the same core data types plus a few that are specific to that market.

​
Common data types

  • search: find bonds matching filters (maturity, coupon, country, rating, etc.). Returns a compact set of fields.
  • reference: full reference data for a list of ISINs.
  • pricing_latest: most recent price for each ISIN.
  • pricing_history: historical price series.
  • cashflows: projected interest and principal schedules.

​
Universe-specific endpoints

Government yield curves:
  • government_yield_curve for government par, zero, and benchmark yield curves by region and date.
Inflation factors: US municipal additionally exposes:
  • entity_search: search by issuer or obligor.
  • documents: retrieve official statement and disclosure document keys (which can be downloaded with /api/v1/download_document)
  • pricing_daily_history: a full day of trades across every ISIN at once.
  • price_to_yield: convert between price and yield.
  • bonds_in_series: find sibling ISINs belonging to the same series.
  • events: corporate action history (calls, defeasances, splits, consolidations, etc).
The use of funds taxonomy used in muni reference data is documented in Use of Funds Taxonomy.

​
Utilities

  • convert_to_isin: resolve a list of 9-character US CUSIPs to ISINs. Inputs that aren’t valid CUSIPs come back with isin: null. CUSIP is the only supported input type today.
  • download_document: fetch the content of a document returned by muni_documents. Files can be retrieved as PDFs (as binary stream) or text files. Today only muni disclosure documents are supported.

​
Authentication, limits, errors

All endpoints require a bearer token. See Authentication and Rate limits & quotas. Error responses use the envelope described in Errors.

​
MCP access

The same API is also available as an MCP server for Claude and ChatGPT. See MCP access.