How to Stay Under the Mboum API Rate Limit

Every authenticated Mboum API call counts toward the same rate limit. If your script bursts too fast, the run can stop with an HTTP error instead of returning market data. After this walkthrough, you will know the documented limit, how a 429 looks in a simple request, and that the docs recommend a retry when that happens.

The documented limit is 15 requests per second. Exceeding it can return HTTP 429 Too Many Requests. The docs recommend a retry mechanism when that happens. This post does not document market response fields; it only covers staying under that shared limit.

👉 To access this endpoint, you must obtain an API key: https://mboum.com/pages/api

Rate Limiting

Rate limiting applies across authenticated calls. The example below is one counted request to GET /v1/markets/quote; every authenticated call counts toward the same 15 per second limit.

Documentation:
https://docs.mboum.com/#rate-limiting

Request

GET https://api.mboum.com/v1/markets/quote?ticker=AAPL
Authorization: Bearer YOUR_API_KEY

Parameters

• No rate-limit-specific query parameters. Authenticated requests share the documented 15 requests per second limit.

Choosing the Request

Use any authenticated call as a counted request. For the sample, send one GET to the quote URL with ticker=AAPL. That is only an example of traffic that counts; you are checking the status code, not documenting quote fields.

Do not add invented rate-limit query parameters. There are none listed for this topic beyond the shared per-second limit on every authenticated call.

Sample Response

Shortened example of the rate-limit outcome you handle (not a market body). The only facts shown are the documented limit and HTTP 429:

{
  "documented_limit": "15 requests per second",
  "when_exceeded": "HTTP 429 Too Many Requests",
  "docs_recommend": "a retry"
}

Python Example

import requests

url = "https://api.mboum.com/v1/markets/quote"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
params = {"ticker": "AAPL"}

response = requests.get(url, headers=headers, params=params)
if response.status_code == 429:
    print("The call was rate limited and should be retried")
else:
    response.raise_for_status()

Understanding the Response

• HTTP 429 Too Many Requests can be returned when the documented 15 requests per second limit is exceeded
• The docs recommend a retry mechanism
• This example does not document quote response fields

Treat status code first: if you see 429, the call should be retried per the docs; otherwise raise on other HTTP errors and continue your own workflow.

Walkthrough

• Send one authenticated request (the quote URL is only an example of a counted call).
• Check whether status_code is 429.
• If it is 429, treat the call as rate limited and retry; otherwise raise on other errors and keep going.

Watch for This

Every authenticated call shares that same per-second limit. A burst across endpoints still counts against the single 15 requests per second ceiling.

Keep your scripts aware of 429, stay within 15 requests per second, and retry when the docs say to. That is the full happy path for rate limiting on Mboum, without inventing sleep timers or plan-specific caps.

👉 Get your API key and build within the documented rate limit: https://mboum.com/pages/api