Development
Understanding how our endpoints are organized.
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, whereas themuni
endpoints cover the US municipal bond market. The 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
andpricing_history
endpoints are meant for fetching the latest or historical pricing data on a set of ISINs, respectively.
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:
-
Starter Tier:
- API rate limit: 25 requests per minute.
- ISINs Limit: You can use up to 500 ISINs per month, resets every month.
- Access to Reference and Pricing resources.
- Price history of 1 month.
-
Build Tier:
- API rate limit: 100 requests per minute.
- ISINs Limit: Higher limit with 5,000 ISINs per month, resets every month.
- Access to Reference, Pricing, and Cashflows resources.
- Price history of 1 year.