How to Get a Ticker Market Summary with the Mboum API

Staff Member

Sep 27, 2026

A ticker market summary packs the labeled fundamentals your UI needs beside a price: exchange, sector, market cap, P/E, EPS, volume, and dividend fields in one call. After you send a required ticker and asset-class type, you can read body.symbol, walk body.summaryData, and print each entry's label and value.

This tutorial covers GET /v2/markets/stock/ticker-summary. ticker is required (symbol is also accepted). type is required and must be STOCKS, ETF, MUTUALFUNDS, or FUTURES. The example below uses ticker=AAPL&type=STOCKS.

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

The Ticker Summary Endpoint

Summaries live under GET /v2/markets/stock/ticker-summary.

Documentation:
https://docs.mboum.com/#stocks-options-GETapi-v2-markets-stock-ticker-summary

Request

GET https://api.mboum.com/v2/markets/stock/ticker-summary?ticker=AAPL&type=STOCKS
Authorization: Bearer YOUR_API_KEY

Parameters

ticker — required. Company symbol (example AAPL). symbol is also accepted
type — required. One of STOCKS, ETF, MUTUALFUNDS, or FUTURES

Choosing the Request

For this walkthrough, send ticker=AAPL and type=STOCKS. That keeps the call on a familiar equity while you learn the summaryData shape.

Do not omit type, and do not invent extra summary keys beyond the ones listed below. Stay on this v2 ticker-summary path so each entry's label and value match what you inspect.

Sample Response

The shortened sample below shows body.symbol plus a few summaryData entries. Each entry is an object with label and value:

{
  "body": {
    "symbol": "AAPL",
    "summaryData": {
      "Exchange": {"label": "Exchange", "value": "NASDAQ"},
      "Sector": {"label": "Sector", "value": "Technology"},
      "Industry": {"label": "Industry", "value": "Consumer Electronics"},
      "MarketCap": {"label": "Market Cap", "value": "3.4T"},
      "PERatio": {"label": "P/E Ratio", "value": "33.40"},
      "EarningsPerShare": {"label": "Earnings Per Share", "value": "6.57"},
      "FiftTwoWeekHighLow": {"label": "52 Week High/Low", "value": "237.23/164.08"},
      "Yield": {"label": "Yield", "value": "0.44%"}
    }
  }
}

Python Example

import requests

url = "https://api.mboum.com/v2/markets/stock/ticker-summary"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
params = {"ticker": "AAPL", "type": "STOCKS"}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
body = (response.json().get("body") or {})
summary = body.get("summaryData") or {}
print(body.get("symbol"))
for key in ("MarketCap", "PERatio", "EarningsPerShare", "FiftTwoWeekHighLow", "Yield"):
    entry = summary.get(key) or {}
    print(key, entry.get("label"), entry.get("value"))

Understanding the Response

body.symbol echoes the ticker you requested
body.summaryData holds labeled fields; each entry has label and value
Use these keys: Exchange, Sector, Industry, OneYrTarget, TodayHighLow, ShareVolume, AverageVolume, PreviousClose, FiftTwoWeekHighLow, MarketCap, PERatio, ForwardPE1Yr, EarningsPerShare, AnnualizedDividend, ExDividendDate, DividendPaymentDate, Yield, and Beta

Read label for the display name and value for the figure. That split lets you render a profile card without renaming keys yourself.

Walkthrough

Call ticker-summary with required ticker and type (or accepted symbol plus type).
Confirm body.symbol, then open body.summaryData.
Print a few entries by reading each object's label and value, including FiftTwoWeekHighLow.

Watch for This

The 52-week key is spelled FiftTwoWeekHighLow. Read label for the display name and value for the figure, instead of inventing your own field names from the key alone.

Stay on ticker-summary with both required parameters until you have printed live labels and values for market cap, P/E, and the 52-week range. That one call is enough to fill an overview card before you reach for other fundamentals endpoints.

👉 Get your API key and pull ticker summaries: https://mboum.com/pages/api