expertise

Fetch historical OHLCV price series for any ticker: stocks (AAPL, SAP.DE, 7203.T), ETFs, indices, commodities (GC=F for

Fetch historical OHLCV price series for any ticker: stocks (AAPL, SAP.DE, 7203.T), ETFs, indices, commodities (GC=F for gold) or cryptocurrencies (BTC-USD). Returns a full date-indexed series of open/high/low/close/volume plus pre-computed statistics: total return, annualised return (CAGR), annualised volatility, max drawdown and Sharpe estimate (rf=4%). Automatically detects crypto tickers (→ CoinGecko) vs traditional assets (→ Yahoo Finance primary, Stooq fallback). Adjusts for dividends and splits when adjusted=true (default). Use cases: backtesting, factor analysis, performance attribution, charting, financial modelling. Sources: Yahoo Finance, CoinGecko, Stooq. All keyless. Optional env: AICI_RESEARCH_PROXY_URL for Bright Data routing (lifts Yahoo 429), TWELVE_DATA_API_KEY for higher Twelve Data quota.

post/api/v1/call/historical_price_series

Request

  • Base URL: https://mcp.gapup.io
  • URL: https://mcp.gapup.io/api/v1/call/historical_price_series
  • Auth: HTTP bearer

Request body

tickerstring required

Yahoo Finance ticker symbol. Examples: AAPL (US stock), SAP.DE (Frankfurt), 7203.T (Tokyo), BTC-USD (Bitcoin), GC=F (gold futures), ^GSPC (S&P 500).

interval'1d' | '1wk' | '1mo'

Bar interval. Default: 1d (daily).

period'1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y' | '10y' | 'max'

Look-back period. Default: 1y.

adjustedboolean

Adjust close prices for dividends and splits. Default: true.

metricsstring[]

Subset of fields to include (informational — all fields always returned).

asyncboolean

If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts.

Response

Tool result

toolstring
request_idstring
source'rest-api'
msnumber

Changes

No recorded changes to this operation across all 1 revision of this API.