Skip to main content
Available as MCP tool: equity_historical_prices — call directly from Claude / Cursor / any MCP client. See MCP Server for the 60-second setup.
Live   1 credit per call

​
What it does for your agent

equity_historical_prices returns daily OHLCV bars for a single US equity (NYSE / NASDAQ), plus adjusted_close, dividend, and stock_split per bar. Use it as the historical pricing primitive an agent reaches for whenever it needs returns, drawdowns, or backtest data — not for the latest tick. Two query modes share one endpoint: pass limit to get the most recent N closed days, or pass start_date + end_date for an exact window. Only closed trading days are returned — the in-progress day is never included.

​
Response

​
data
EquityHistoricalResult
required
​
meta.count
number
Number of bars returned.
​
meta.creditsUsed
number
Credits consumed (always 1).
​
meta.remainingCredits
number
Account credits remaining.
200 OK · equity_historical_prices
{
  "data": {
    "ticker": "AAPL",
    "interval": "1d",
    "prices": [
      {
        "open": 178.50,
        "high": 182.30,
        "low": 177.80,
        "close": 181.20,
        "volume": 52340000,
        "adjusted_close": 181.20,
        "dividend": 0.24,
        "stock_split": 0,
        "time": "2025-03-28"
      },
      {
        "open": 181.00,
        "high": 183.50,
        "low": 180.20,
        "close": 182.90,
        "volume": 48120000,
        "adjusted_close": 182.90,
        "dividend": 0,
        "stock_split": 0,
        "time": "2025-03-31"
      }
    ]
  },
  "meta": { "count": 2, "creditsUsed": 1, "remainingCredits": 99 }
}

​
Notes

For return calculations, always use adjusted_close — it bakes in dividends and splits. Plain close is only safe when you’re rendering raw price charts.
The first request for a ticker + range can be slower. Subsequent identical queries usually return faster.
US equities only (NYSE / NASDAQ). No ADRs of non-US listings, no international markets.
Daily interval only. Minute-level (1m, 5m, 15m) and hourly bars are not exposed.
No real-time quote. The current trading day is excluded until market close. For latest price, this tool isn’t the right primitive.
Coverage is broad but not guaranteed. A handful of less-liquid tickers may occasionally return empty.

​
Direct invocation

// Recent mode — last 30 trading days
{
  "method": "tools/call",
  "params": {
    "name": "equity_historical_prices",
    "arguments": { "ticker": "AAPL", "limit": 30 }
  }
}

// Range mode — explicit window
{
  "method": "tools/call",
  "params": {
    "name": "equity_historical_prices",
    "arguments": {
      "ticker": "MSFT",
      "start_date": "2025-04-01",
      "end_date": "2025-04-30"
    }
  }
}

​
Full parameter reference

​
ticker
string
required
US equity ticker (e.g. AAPL, MSFT, BRK.B, ^GSPC for S&P 500 index).
Pass limit only (or omit it for the default). Returns the most recent N closed trading days.
​
limit
integer
default:30
Number of recent trading days. Default 30. Max 200.

Crypto Historical Klines

Same shape (Recent / Range modes) for crypto pairs at sub-daily intervals.

MCP Server setup

Connect Claude / Cursor / any harness in 60 seconds.