Skip to main content
At Terrapin we are dedicated to improving access to data on over-the-counter (OTC) instruments, starting with fixed income. Our goal is to bring you high quality data on global bonds, including both reference and pricing, with the best possible API.
Before you start, make sure to get an API key here.

​
Coverage

The API currently includes reference, pricing and cash flow data on about 35,000 government and corporate bonds and 1.2 million US municipal bonds.

​
Endpoints

The endpoints in this API reference are split along 2 axes: the type of data being fetched and the universe being fetched.
  • The bond endpoints cover data on government and corporate bonds;
  • The muni endpoints cover the US municipal bond market.
Munis are split from the rest of the bonds as they have unique characteristics and data schemas.
  • The search endpoints are meant for searching according to user-defined filters, such as maturity ranges, currency, country, etc. This endpoint will return a limited set of fields for each bond. This endpoint does not count toward your ISIN quota, so you can make as many searches as you want.
  • The reference endpoints are meant for fetching the full reference data on a particular set of ISINs.
  • The pricing_latest and pricing_history endpoints are meant for fetching the latest or historical pricing data on a set of ISINs, respectively. The muni_pricing_daily_history allows to fetch historical pricing data for all ISINs at a given day.
Note: to receive the data in csv format, use the header 'Accept: text/csv' in your request. Using text/csv will bypass the default query limit of 1000 returns per request (with pagination), so we recommend that it is only used when you actually intend to download data in bulk into a csv file.

​
API Usage Limits for Different Tiers

There are distinct usage limitations on our API depending upon the type of subscription tier. Below is an overview of the limitations for each tier:
  • Startup Tier:
    • API rate limit: 100 requests per minute.
    • ISINs Limit: Higher limit with 3,000 ISINs per month, resets every month.
    • Access to Reference, Pricing, and Cashflows resources.
    • Price history of 1 year.
API rate limit implementation follows IETF draft v7 RateLimit header fields for HTTP.

​
Further Resources

Check out a ready-to-use Python notebook with examples for searching for reference data, pricing data and cashflows. Open in Colab