Endpoint
Authentication
Parameters
Required
The stock ticker symbol (e.g.
AAPL, MSFT, GOOGL).Optional
Start of date range (
YYYY-MM-DD, e.g. 2025-04-01). Must be used together with end_date.End of date range (
YYYY-MM-DD). Must be used together with start_date.Maximum number of bars to return. Default
30, max 200. When start_date/end_date are provided, limit acts as a safety cap only.Query Modes
This endpoint supports two mutually exclusive query modes:| Mode | Parameters | Behavior |
|---|---|---|
| Recent | limit only (or omit for default) | Returns the most recent N closed trading days |
| Range | start_date + end_date | Returns all closed trading days within the date range |
start_date or only end_date returns a 400 error.
Response
Credits
Each call consumes 1 credit, regardless of the number of bars returned.Code Examples
Example Response
Notes
- US equities only — NYSE and NASDAQ listed stocks.
- Daily interval only — minute-level data is not available.
- Closed trading days only — the current trading day is not included until market close.
- No real-time quotes — use this endpoint for historical data, not latest prices.
- First request latency — the first query for a given ticker + range may be slower as data is fetched from yfinance and cached. Subsequent queries for the same range return instantly.
- Data source — powered by yfinance (unofficial); approximately 98% success rate.