Authentication and Rate Limits

All API calls must be authenticated with an API key. Passing an API key simply requires passing it in the URL as a parameter (ie. appending &api_key=YOUR_API_KEY). If you do not pass an API key, or an invalid key, you will receive a 401 HTTP status code.

A trial API key can be requested by filling out this form: https://docs.google.com/forms/d/1BKxD9R0oi-vuKqBVsr7KLBWiNwW_vwPFjixNylHmRaw/viewform?edit_requested=true

You can use the test API key 'bloomberrytest' in the API Reference/Explorer to see sample live, real results, but time period filters + volume of results will be limited for all endpoints.

Rate Limits

All API keys come with a rate limit. We have 2 rate limits: the maximum # of calls you can make in any 10 second timeframe, and the maximum # of calls you can make in a calendar month.

These rate limits will appear in your response headers as follows:

X-RateLimit-Reset: The Unix epoch time at which the rate limit for the 10 second time frame expires.

X-RateLimit-Limit: The maximum number of calls you can make in any 10 second time frame.

X-RateLimit-Month-Remaining: The number of remaining calls you can make in the current calendar month. This resets in the 1st of every month (midnight EST)

X-RateLimit-Remaining: The number of remaining calls you can make in the current 10 second time frame.

If you need higher rate limits, or need to make more calls, please contact your account manager and we can arrange to have you in a higher API plan.