image

Read upgrade and downgrade history by requesting the upgrade-downgrade-history module and printing the keys that come back.

The docs describe upgrade-downgrade-history as upgrade and downgrade history. The names inside it are the keys the response prints.

To access this endpoint, you must obtain an API key: Get your API key

Request upgrade and downgrade history

GET /v1/markets/stock/modules with ticker AAPL and module upgrade-downgrade-history asks for that history. Timeframe stays unset on this module.

Method: GET

URL: https://api.mboum.com/v1/markets/stock/modules

Documentation: stock modules

Read the printed names

A dict body prints as a sorted key list. Any other body prints as its type name. That line is the history record.

import requests

url = "https://api.mboum.com/v1/markets/stock/modules"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
params = {"ticker": "AAPL", "module": "upgrade-downgrade-history"}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
payload = response.json()
body = payload["body"]
if isinstance(body, dict):
    print(sorted(body.keys()))
else:
    print(type(body).__name__)

One limitation: upgrade-downgrade-history has no published child keys, so the script's print is the record of the names.

Learn more or explore other endpoints: stock modules

How to Read Net Share Purchase Activity with the Mboum API Oct 27, 2026

How to Read Net Share Purchase Activity with the Mboum API

Net share purchase activity for one company is a single object, and you store the keys that object prints once the module label matches.

How to Read Key Statistics for a Company with the Mboum API Oct 24, 2026

How to Read Key Statistics for a Company with the Mboum API

Read a company's key statistics by requesting the statistics module and printing the keys that come back.

How to Pull SEC Filings for a Ticker with the Mboum API Oct 23, 2026

How to Pull SEC Filings for a Ticker with the Mboum API

Open a company's SEC filing from the HTML link on the first row returned for that ticker.

How to Filter Insider Trades by Buy or Sell with the Mboum API Oct 23, 2026

How to Filter Insider Trades by Buy or Sell with the Mboum API

Filter insider trades down to buys by keeping every row whose transactionType is Buy.