The range of an intraday bar is the high minus the low, and the close shows where that bar finished inside the range.
This walkthrough follows the intraday response example, where each row carries a clock time.
To access this endpoint, you must obtain an API key: Get your API key
Request the example window
startDate and endDate on an intraday interval are 14 digits, YYYYMMDDHHMMSS. The request is the window published with the response example.
Place the close inside the range
Subtract low from high. When that span is wider than zero, divide the close's distance from the low by the span. The script prints the clock time, the span, and that position.
import requests
url = "https://api.mboum.com/v3/markets/historical"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
params = {
"ticker": "AAPL",
"interval": "5min",
"limit": 640,
"startDate": "20250404000000",
"endDate": "20250604000000",
}
response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
payload = response.json()
for bar in payload.get("body", [])[:5]:
span = bar["high"] - bar["low"]
position = None if span == 0 else (bar["close"] - bar["low"]) / span
print(bar["datetime"], span, position)
The excerpt is the first bar in the example file, and the file continues after it. datetime has a date and a clock time. The example file also echoes limit, order, dividends, and splits.
{
"meta": {
"ticker": "AAPL",
"interval": "5min",
"startDate": "20250404000000",
"endDate": "20250604000000"
},
"body": [
{
"datetime": "2025-05-21 14:40",
"high": 202.3598,
"low": 201.9463,
"close": 202.18
}
]
}
When the clock is the wrong width
A startDate that is not 14 digits on an intraday interval returns status 400 and the message: Invalid startDate format for intraday interval. Must be YYYYMMDDHHMMSS format (e.g., 20260101000000). endDate uses that same width. Daily, weekly, monthly, and quarterly rows carry symbol and date instead of datetime, so this division reads the intraday fields.
Learn more or explore other endpoints: Mboum v3 historical bars
