Schedulers and dashboards need to know if the session is pre-market, regular hours, or after hours before they pull quotes or fire alerts. Guessing from the clock alone misses holidays and early closes.
One Mboum market-info request returns the current U.S. session state, countdown timers, and the clock times around the open and close so you can gate the rest of your market jobs.
👉 To access this endpoint, you must obtain an API key: https://mboum.com/pages/api
The Market Info Endpoint
Market session status lives under GET /v2/markets/market-info. The documented request has no query parameters.
Documentation:
https://docs.mboum.com/#stocks-options-GETapi-v2-markets-market-info
Request
GET https://api.mboum.com/v2/markets/market-info
Authorization: Bearer YOUR_API_KEYParameters
None. Call the path with your API key only.
Python Example
import requests
url = "https://api.mboum.com/v2/markets/market-info"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(url, headers=headers)
response.raise_for_status()
body = response.json().get("body", {})
print(body.get("mrktStatus"), body.get("mrktCountDown"))
Understanding the Response
The JSON body describes the U.S. session. Fields include:
countrymarketIndicatoruiMarketIndicatormarketCountDownpreMarketOpeningTimepreMarketClosingTimemarketOpeningTimemarketClosingTimeafterHoursMarketOpeningTimeafterHoursMarketClosingTimepreviousTradeDatenextTradeDateisBusinessDaymrktStatusmrktCountDown
Practical Use Cases
Use market-info to pause quote polls outside regular hours, show a pre-market or after-hours badge in a dashboard, or schedule jobs against the next trade date instead of a hard-coded weekday calendar.
👉 Get your API key and check the session: https://mboum.com/pages/api
