# Terrapin - [Welcome to Terrapin](https://docs.terrapinfinance.com/introduction.md): The modern fixed-income data API. - [Authentication](https://docs.terrapinfinance.com/authentication.md): Authenticate your requests with a bearer token. - [Rate limits & quotas](https://docs.terrapinfinance.com/rate-limits-and-quotas.md): Request throttling, ISIN quotas, and the headers we return. - [Errors](https://docs.terrapinfinance.com/errors.md): How to interpret error responses. - [Government & corporate bonds](https://docs.terrapinfinance.com/data_dictionary_govies_corps.md): Field reference for the government & corporate bond Reference Data response - [US agency bonds](https://docs.terrapinfinance.com/data_dictionary_agencies.md): Field reference for the US agency bond Reference Data response - [Expanded Government & corporate bonds (preview)](https://docs.terrapinfinance.com/data_dictionary_securities.md): Field reference for the Expanded Government & corporate bond Reference Data response - [US municipal bonds](https://docs.terrapinfinance.com/data_dictionary_munis.md): Field reference for the US municipal bond Reference Data response - [Inflation factors](https://docs.terrapinfinance.com/inflation_factors.md): Inflation factors calculation and usage - [Use of Funds Taxonomy](https://docs.terrapinfinance.com/use_of_funds_taxonomy.md): Classification system for US municipal bond proceeds - [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. - [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. - [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. - [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. - [Cash Flows](https://docs.terrapinfinance.com/api-endpoints/government-and-corporate-cashflows.md): Get cash flow schedules for fixed or zero rate bonds. - [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. - [Government Yield Curve](https://docs.terrapinfinance.com/api-endpoints/government-yield-curve.md): Retrieve government yield curve points for a given date, region, and curve type. - [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. - [Reference Data](https://docs.terrapinfinance.com/api-endpoints/us-agency-bond-reference.md): Get full US agency bond reference data for given ISINs. - [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. - [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. - [Cash Flows](https://docs.terrapinfinance.com/api-endpoints/us-agency-cashflows.md): Get cash flow schedules for fixed or zero rate bonds. - [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. - [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. - [Reference Data](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-reference.md): Get full US municipal bond reference data for given ISINs. - [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… - [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. - [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. - [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. - [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. - [Cash Flows](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-cashflows.md): Get cash flow schedules for US municipal bonds. - [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. - [Event History](https://docs.terrapinfinance.com/api-endpoints/us-municipal-bond-events.md): Get US municipal bond event history for given ISINs. - [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. - [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. - [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. - [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. - [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, this returns a short-lived download URL instead of the file content; fetch it with your own tooling (e.g. `curl -sL '' | pdftotext - -` for P… - [Bond Search](https://docs.terrapinfinance.com/api-endpoints/securities-search.md): This endpoint returns a list of corporate bonds, government bonds and certificates of deposit with a small set of fields. - [Reference Data](https://docs.terrapinfinance.com/api-endpoints/securities-reference.md): Get full corporate, government bond and certificate of deposit reference data for given ISINs. - [Latest Pricing](https://docs.terrapinfinance.com/api-endpoints/securities-pricing-latest.md): Get the latest end of day corporate and US agency bond pricing data for a given set of ISINs. - [Historical Pricing](https://docs.terrapinfinance.com/api-endpoints/securities-pricing-history.md): Get historical corporate and US agency bond pricing data for a given ISIN. - [Cash Flows](https://docs.terrapinfinance.com/api-endpoints/securities-cashflows.md): Get cash flow schedules for fixed or zero rate bonds. - [MCP access](https://docs.terrapinfinance.com/mcp/introduction.md): Connect Terrapin to Claude or ChatGPT via the Model Context Protocol. - [Network access](https://docs.terrapinfinance.com/mcp/network-access.md): Allow terrapinfinance.com when your MCP client runs in a sandbox. - [Welcome to Terrapin](https://docs.terrapinfinance.com/platform-guide/introduction.md): A tour of the Credit Intelligence platform. - [Common workflows](https://docs.terrapinfinance.com/platform-guide/common-workflows.md): End-to-end recipes for the most common analyst tasks. - [Screeners](https://docs.terrapinfinance.com/platform-guide/explorers.md): Search the whole municipal universe: securities, trades and filings. - [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. - [Documents](https://docs.terrapinfinance.com/platform-guide/deep-dive/documents-and-filters.md): Control which disclosure documents Deep Dive reads. - [Skills](https://docs.terrapinfinance.com/platform-guide/deep-dive/skills.md): Save instructions you use often and drop them into a question. - [Watchlists overview](https://docs.terrapinfinance.com/platform-guide/watchlists/introduction.md): Group the CUSIPs and entities you want to monitor or analyse at scale. - [Coverage](https://docs.terrapinfinance.com/platform-guide/watchlists/coverage.md): What every watchlist tracks for its securities, with no setup. - [Data Tables](https://docs.terrapinfinance.com/platform-guide/data-tables.md): Compare metrics across every entity in a watchlist. - [Tear Sheets](https://docs.terrapinfinance.com/platform-guide/tear-sheets.md): Run the same narrative credit write-up across every entity in a watchlist. - [Surveillance](https://docs.terrapinfinance.com/platform-guide/surveillance.md): A cross-watchlist event feed for everything happening on your portfolio. - [Writing effective prompts](https://docs.terrapinfinance.com/platform-guide/writing-effective-prompts.md): How to phrase prompts so the right evidence is found and the answer comes back usable. ## OpenAPI Specs - [openapi_spec](/openapi_spec.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.