What inputs does get_price_history accept?

ticker (string, required): Stock ticker symbol, e.g. AAPL, MSFT — or a CIK (SEC identifier), e.g. '0000320193'. start_date (string, optional): 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. end_date (string, optional): 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. limit (integer, optional, default 252): 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.

Which Valuein plans include get_price_history?

Available on Pro and Institutional. Not point-in-time safe.

Discovery

Price History (date range)

get_price_history

Pro and above

Daily 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-comp...

Example Call

example_call.pypython

# Using the Valuein MCP server from Python (via MCP SDK)# Or call directly from Claude / Cursor after setup result = await client.call_tool(    "get_price_history",    arguments={    "ticker": "EXAMPLE"})print(result)

Direct tool call:get_price_history(...)

Inputs

Parameter	Type	Required	Description
`ticker`	string	required	Stock ticker symbol, e.g. AAPL, MSFT — or a CIK (SEC identifier), e.g. '0000320193'.
`start_date`	string	optional	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.
`end_date`	string	optional	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.
`limit`	integer	optional	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.Default: `252`

Output Fields

tickerplancikcompany_namestart_dateend_datebar_countgranularitybarsnote

Example Response

Illustrative

response.jsonjson

{  "ticker": "AAPL",  "plan": "sp500",  "cik": "0000320193",  "company_name": "Apple Inc.",  "start_date": null,  "end_date": null,  "bar_count": null,  "granularity": null}