A symbol page that shows only a last price still leaves the AAPL overview card missing exchange, sector, market cap, P/E, EPS, and yield.
This guide calls GET /v2/markets/stock/ticker-summary with ticker=AAPL and type=STOCKS, then reads body.symbol and the sample summaryData entries, including MarketCap 3.4T, PERatio 33.40, and FiftTwoWeekHighLow 237.23/164.08.
To access this endpoint, you must obtain an API key: Get your API key
The Endpoint
Labeled fundamentals for one ticker live on this path. ticker is required, and symbol is also accepted. type is required. The sample uses AAPL and STOCKS. Each summaryData entry has label and value.
Method: GET
Endpoint: https://api.mboum.com/v2/markets/stock/ticker-summary?ticker=AAPL&type=STOCKS
Documentation: Ticker summary
Parameters
- ticker: required company symbol. The sample uses AAPL. symbol is also accepted.
- type: required. One of STOCKS, ETF, MUTUALFUNDS, or FUTURES. The sample uses STOCKS.
Python Example
The function requests the AAPL stock summary and prints label and value for the sample keys, including the 52-week key spelled FiftTwoWeekHighLow.
import requests
def fetch_summary():
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()
return response.json()
body = (fetch_summary().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 is AAPL. The sample summaryData entries are Exchange NASDAQ, Sector Technology, Industry Consumer Electronics, MarketCap 3.4T, PERatio 33.40, EarningsPerShare 6.57, FiftTwoWeekHighLow 237.23/164.08 with label 52 Week High/Low, and Yield 0.44%. Read label for the display name and value for the figure.
{
"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%"}
}
}
}The 52-week key is spelled FiftTwoWeekHighLow. In the sample its value is 237.23/164.08. Other summaryData keys on this endpoint, each with label and value, are OneYrTarget, TodayHighLow, ShareVolume, AverageVolume, PreviousClose, ForwardPE1Yr, AnnualizedDividend, ExDividendDate, DividendPaymentDate, and Beta.
Key Fields
- Identity: body.symbol echoes the ticker. The sample is AAPL. Each summaryData entry has label and value.
- Profile labels: Exchange, Sector, and Industry. The sample values are NASDAQ, Technology, and Consumer Electronics.
- Valuation and range: MarketCap, PERatio, EarningsPerShare, FiftTwoWeekHighLow, and Yield. The sample values are 3.4T, 33.40, 6.57, 237.23/164.08, and 0.44%.
- Other labeled entries: OneYrTarget, TodayHighLow, ShareVolume, AverageVolume, PreviousClose, ForwardPE1Yr, AnnualizedDividend, ExDividendDate, DividendPaymentDate, and Beta.
Practical Use Cases
Overview card for AAPL
Request ticker AAPL and type STOCKS, then print Market Cap 3.4T, P/E Ratio 33.40, and Earnings Per Share 6.57 from each entry's label and value.
Range and yield on the same card
Read FiftTwoWeekHighLow, whose sample value is 237.23/164.08 and whose label is 52 Week High/Low, next to Yield 0.44%.
Learn more or explore other endpoints: Ticker summary
