# Terrapin

## Docs

- [Convert CUSIPs to ISINs](https://docs.terrapinfinance.com/api-endpoints/convert-to-isin.md): Convert a list of 9-character US CUSIPs into ISINs.
- [Download Document](https://docs.terrapinfinance.com/api-endpoints/download-document.md): Given a Terrapin file ID (obtained from the muni_documents endpoint), returns the PDF or text content of the document. When using within an agent or MCP, only request TXT files, never PDFs.
- [Bond Search](https://docs.terrapinfinance.com/api-endpoints/government-and-corporate-bond-search.md): This endpoint returns a list of bonds matching the search filters.       Each bond in the response includes fields such as ISIN, Issuer name, coupon, maturity date, currency, and ticker.
- [Cash Flows](https://docs.terrapinfinance.com/api-endpoints/government-and-corporate-cashflows.md): Get cash flow schedules for fixed or zero rate bonds.
- [Historical Pricing](https://docs.terrapinfinance.com/api-endpoints/government-and-corporate-historical-pricing-data.md): Get historical government and corporate bond end of day pricing data for a given ISIN.
- [Latest Pricing](https://docs.terrapinfinance.com/api-endpoints/government-and-corporate-latest-pricing-data.md): Get latest end of day government and corporate bond pricing data for a given set of ISINs.
- [Reference Data](https://docs.terrapinfinance.com/api-endpoints/government-and-corporate-reference-data.md): Get full government and corporate bond reference data for a given set of ISINs.
- [Inflation Factors](https://docs.terrapinfinance.com/api-endpoints/government-inflation-factors.md): Retrieve inflation factors for a given country and date range.     Inflation factors are used to adjust principal and coupon payments of inflation-linked bonds to account for changes in the price level.
- [Reference Data](https://docs.terrapinfinance.com/api-endpoints/us-agency-bond-reference.md): Get full US agency bond reference data for given ISINs.
- [Bond Search](https://docs.terrapinfinance.com/api-endpoints/us-agency-bond-search.md): This endpoint returns a list of US agency bonds with a small set of fields.       It is intended for search according to the filters provided.
- [Cash Flows](https://docs.terrapinfinance.com/api-endpoints/us-agency-cashflows.md): Get cash flow schedules for fixed or zero rate bonds.
- [Historical Pricing](https://docs.terrapinfinance.com/api-endpoints/us-agency-historical-pricing-data.md): Get historical US agency bond end of day pricing data for a given ISIN.
- [Latest Pricing](https://docs.terrapinfinance.com/api-endpoints/us-agency-latest-pricing-data.md): Get latest end of day US agency bond pricing data for a given set of ISINs.
- [Bonds in Series](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-bonds-in-series.md): Given an ISIN, returns all municipal bonds that belong to the same series. Response schema is the same as the muni_search endpoint.
- [Cash Flows](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-cashflows.md): Get cash flow schedules for US municipal bonds.
- [Daily Historical Pricing](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-daily-historical-pricing-data.md): Get historical US municipal bond pricing data for all ISINs at a given day.
- [Documents](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-documents.md): Given an ISIN and document type, returns the unique file IDs and metadata for the documents associated with that municipal bond. For `official_statement`, returns official statements for the specific bond. For `disclosure_document`, returns disclosure documents for the bond's obligor. The file IDs c…
- [Entity Search](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-entity-search.md): Given a search query, returns a list of municipal bond issuers (entities) matching the query. Searches by entity name, state, and counties.
- [Event History](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-events.md): Get US municipal bond event history for given ISINs.
- [Historical Pricing](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-historical-pricing-data.md): Get historical US municipal bond pricing data for a given ISIN.
- [Latest Pricing](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-latest-pricing-data.md): Get the latest end of day US municipal bond pricing data for a given set of ISINs.
- [Price To Yield](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-price-to-yield.md): Calculate yield metrics for municipal securities based on price and settlement date.
- [Reference Data](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-reference.md): Get full US municipal bond reference data for given ISINs.
- [Bond Search](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-search.md): This endpoint returns a list of US municipal bonds with a small set of fields.       It is intended for search according to the filters provided.
- [Issuance Statistics](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-stats-issuance.md): Aggregate statistics on newly issued US municipal debt over a date range: new issuance par value, number of newly issued CUSIPs, and number of issuing entities. New issuance is windowed on the bond's dated date. Excludes commercial paper and new issues still without a final OS.
- [Outstanding Statistics](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-stats-outstanding.md): Aggregate statistics on currently outstanding US municipal debt: total outstanding par value, number of CUSIPs, and number of unique issuing entities. Excludes commercial paper and new issues still without a final OS.
- [Top Issuers](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-stats-top-issuers.md): Ranked list of the top issuers over a date range, combining new issuance and secondary market trade activity. Issuers are ranked by the chosen metric in descending order. Excludes commercial paper and new issues still without a final OS.
- [Trade Activity Statistics](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-stats-trade-activity.md): Aggregate secondary market trade activity over a date range: traded volume (par value), trade count, and the breakdown of customer bought, customer sold, and inter-dealer trades. Excludes commercial paper and new issues still without a final OS.
- [Authentication](https://docs.terrapinfinance.com/authentication.md): Authenticate your requests with a bearer token.
- [Errors](https://docs.terrapinfinance.com/errors.md): How to interpret error responses.
- [Inflation factors](https://docs.terrapinfinance.com/inflation_factors.md): Inflation factors calculation and usage
- [Welcome to Terrapin](https://docs.terrapinfinance.com/introduction.md): The modern fixed-income data API.
- [MCP access](https://docs.terrapinfinance.com/mcp-access.md): Connect Terrapin to Claude or ChatGPT via the Model Context Protocol.
- [Common workflows](https://docs.terrapinfinance.com/platform-guide/common-workflows.md): End-to-end recipes for the most common analyst tasks.
- [Data Tables](https://docs.terrapinfinance.com/platform-guide/data-tables.md): Compare metrics across every entity in a watchlist.
- [Documents & filters](https://docs.terrapinfinance.com/platform-guide/deep-dive/documents-and-filters.md): Control which disclosure documents Deep Dive reads.
- [Deep Dive overview](https://docs.terrapinfinance.com/platform-guide/deep-dive/introduction.md): AI-assisted credit research on US municipal bonds.
- [Sessions](https://docs.terrapinfinance.com/platform-guide/deep-dive/sessions.md): Create, navigate, and manage Deep Dive research sessions.
- [Using prompts in sessions](https://docs.terrapinfinance.com/platform-guide/deep-dive/using-prompts.md): Run saved prompt templates against the current entity with one click.
- [Welcome to Terrapin](https://docs.terrapinfinance.com/platform-guide/introduction.md): A tour of the Credit Intelligence platform.
- [Prompt Templates](https://docs.terrapinfinance.com/platform-guide/prompt-templates.md): Author, manage, and reuse prompts across Deep Dive sessions and watchlists.
- [Surveillance](https://docs.terrapinfinance.com/platform-guide/surveillance.md): A cross-watchlist event feed for everything happening on your portfolio.
- [Assignments](https://docs.terrapinfinance.com/platform-guide/watchlists/assignments.md): Attach automated work to every entity in a watchlist.
- [Watchlists overview](https://docs.terrapinfinance.com/platform-guide/watchlists/introduction.md): Group the CUSIPs and entities you want to monitor or analyse at scale.
- [Rate limits & quotas](https://docs.terrapinfinance.com/rate-limits-and-quotas.md): Request throttling, ISIN quotas, and the headers we return.
- [Use of Funds Taxonomy](https://docs.terrapinfinance.com/use_of_funds_taxonomy.md): Classification system for US municipal bond proceeds

## OpenAPI Specs

- [openapi_spec](https://docs.terrapinfinance.com/openapi_spec.json)