How to Track Market Movers with the Mboum API

A scanner that only knows yesterday's leaderboard is already late when you need today's most-active, advanced, and declined stocks in one payload.

This guide calls GET /v1/markets/movers with type=STOCKS and walks the sample rows for AAPL, XYZ, and ABC. Stay on this v1 path. The v2 movers endpoint is a different URL.

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

The Endpoint

Session movers for one asset class live on this path. The sample sends type=STOCKS so the three tables stay on equities. Each table includes dataAsOf, lastTradeTimestamp, and table.rows.

Parameters

• type: required. One of STOCKS, ETF, MUTUALFUNDS, or FUTURES. The sample uses STOCKS.

Python Example

The function calls v1 movers with type STOCKS, then prints symbol, last sale price, and change for the first rows in each of the three tables.

import requests

def fetch_movers():
    url = "https://api.mboum.com/v1/markets/movers"
    headers = {"Authorization": "Bearer YOUR_API_KEY"}
    params = {"type": "STOCKS"}
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json()

payload = fetch_movers()
body = payload.get("body", {}) or {}
for section in ("MostActiveByShareVolume", "MostAdvanced", "MostDeclined"):
    rows = ((body.get(section) or {}).get("table") or {}).get("rows") or []
    for row in rows[:3]:
        if isinstance(row, dict):
            print(section, row.get("symbol"), row.get("lastSalePrice"), row.get("change"))

Understanding the Response

The sample shows one row in each table, and every table carries dataAsOf of 09/28/2026 and lastTradeTimestamp of 4:00 PM ET. MostActiveByShareVolume lists AAPL, Apple Inc., lastSalePrice $227.50, lastSaleChange +1.20, change 52,184,000, and deltaIndicator up. MostAdvanced lists XYZ, Example Corp, lastSalePrice $12.40, lastSaleChange +1.80, change +17.00%, and deltaIndicator up. MostDeclined lists ABC, Sample Inc, lastSalePrice $8.10, lastSaleChange -0.90, change -10.00%, and deltaIndicator down.

{
  "body": {
    "MostActiveByShareVolume": {
      "dataAsOf": "09/28/2026",
      "lastTradeTimestamp": "4:00 PM ET",
      "table": {
        "rows": [
          {
            "symbol": "AAPL",
            "name": "Apple Inc.",
            "lastSalePrice": "$227.50",
            "lastSaleChange": "+1.20",
            "change": "52,184,000",
            "deltaIndicator": "up"
          }
        ]
      }
    },
    "MostAdvanced": {
      "dataAsOf": "09/28/2026",
      "lastTradeTimestamp": "4:00 PM ET",
      "table": {
        "rows": [
          {
            "symbol": "XYZ",
            "name": "Example Corp",
            "lastSalePrice": "$12.40",
            "lastSaleChange": "+1.80",
            "change": "+17.00%",
            "deltaIndicator": "up"
          }
        ]
      }
    },
    "MostDeclined": {
      "dataAsOf": "09/28/2026",
      "lastTradeTimestamp": "4:00 PM ET",
      "table": {
        "rows": [
          {
            "symbol": "ABC",
            "name": "Sample Inc",
            "lastSalePrice": "$8.10",
            "lastSaleChange": "-0.90",
            "change": "-10.00%",
            "deltaIndicator": "down"
          }
        ]
      }
    }
  }
}

Read the section name before you interpret change. On MostActiveByShareVolume it is share volume, which is 52,184,000 for AAPL. On MostAdvanced and MostDeclined it is percent change: +17.00% for XYZ and -10.00% for ABC. lastSalePrice is a display string that includes a dollar sign, so strip that before any numeric comparison.

Key Fields

• Tables: body.MostActiveByShareVolume, body.MostAdvanced, and body.MostDeclined each include dataAsOf, lastTradeTimestamp, and table.rows.
• Row identity: symbol, name, and deltaIndicator. The sample symbols are AAPL, XYZ, and ABC, with deltaIndicator up, up, and down.
• Price and change: lastSalePrice, lastSaleChange, and change. On the share-volume table change is volume. On the advanced and declined tables change is percent change.

Practical Use Cases

Most-active stocks by share volume

Call movers with type=STOCKS and read MostActiveByShareVolume. In the sample, AAPL shows lastSalePrice $227.50 and change 52,184,000, which is share volume on that table.

Advance and decline names from the same payload

Read MostAdvanced and MostDeclined beside the volume table. In the sample, XYZ is +17.00% with deltaIndicator up, and ABC is -10.00% with deltaIndicator down.

Learn more or explore other endpoints: Market movers