Price History (date range)
get_price_historyDaily EOD bar series (OHLCV) for a company over a date range. Returns up to 252 trading-day bars oldest-first — one bar per trading day. Each bar carries: open / high / low / close (raw, unadjusted), total_return_index (dividends reinvested and splits neutralized, forward-compounded from an arbitrary base so only RATIOS of it are meaningful — TOTAL RETURN BETWEEN TWO DATES IS tri_b / tri_a - 1; it is PIT-immutable, so a later dividend appends rather than restating), adjusted_close (a back-adjusted series — SPARSELY POPULATED, usually null, and retroactively restated on each corporate action so it is NOT PIT-immutable; prefer total_return_index), volume (shares traded), div_cash (ex-dividend cash per share on that date, 0 on non-dividend days), and split_factor (1.0 on non-split days). Never compute a return from raw close — a 4-for-1 split reads as a 75% crash. If total_return_index is null across the returned bars (a tier that has not re-exported since schema 2.29.0), the response note says so and you should compound close with div_cash / split_factor instead. For a company with more than one listing (dual-class, CVR), bars are the requested share class where the data supports it; listing_resolution and multi_listing on the response say which listing you actually received. Omit start_date for the trailing year before end_date. Omit end_date for the latest available close. Coverage follows your plan's tier slice: Pro and Institutional get the full daily bar series (full = all companies & all archived history, pro = all companies & last 15 years). On the free plans (sample, benchmark) this tool returns MONTH-END bars instead of daily ones: the close on the last trading day of each calendar month in range (not an average), COMPLETED months only (the month in progress appears once it ends), unadjusted, from up to 360 months (~30 years) of the same archive at coarser granularity — open/high/low/volume/adjusted_close are null on a monthly bar (nothing intraday to report), and close/total_return_index/div_cash/split_factor are populated. The response's granularity field says which series answered the call ('daily' or 'monthly'), and a monthly response's note spells out the upgrade path to daily bars. What every plan additionally has — the valuation multiples at each fiscal year end via get_financial_ratios (category 'valuation') and get_valuation_metrics, and 1/3/6/12-month momentum plus the 52-week high/low via get_earnings_signals. This archive is market data, NOT EDGAR, so it does NOT share the 1993 EDGAR floor that applies to fundamentals: the earliest bar differs per security and is 1994 or later. A request before a security's first bar returns zero bars on every tier, Institutional included, and is reported as DATA_COVERAGE rather than a plan limit.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticker": "<ticker>"
},
"name": "get_price_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of bars to return. Daily plans (Pro, Institutional): 1–252, default 252 ≈ 1 trading year. Free plans (sample, benchmark), which return month-end bars: 1–360, covering up to the full ~30-year monthly archive. When the range contains more bars than `limit`, the most recent `limit` bars within the range are returned. | |
| ticker | Yes | Stock ticker symbol, e.g. AAPL, MSFT — or a CIK (SEC identifier), e.g. '0000320193'. | |
| end_date | No | Inclusive end of the date range (YYYY-MM-DD). Defaults to today (the latest available close). Weekends and holidays resolve to the last trading close on or before this date. | |
| start_date | No | Inclusive start of the date range (YYYY-MM-DD). Bars on or after this date are returned (up to `limit`). Omit to receive the `limit` most-recent bars before end_date. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cik | Yes | ||
| bars | Yes | ||
| note | Yes | ||
| plan | Yes | ||
| _meta | Yes | Provenance envelope — data lineage for every MCP response | |
| ticker | Yes | ||
| end_date | Yes | ||
| bar_count | Yes | ||
| start_date | Yes | ||
| granularity | Yes | ||
| company_name | Yes |