{"uid":"cap_Wij5HqMatv68JQOUn5WlW","slug":"gapup-historical-price-series-a524e4c3","name":"Gapup Historical Price Series","description":"REST gateway for the Gapup MCP catalogue — 271 AI tools accessible via standard HTTP. Authentication via Authorization: Bearer <api_key>. Native MCP transport available at /mcp.","url":"https://mcp.gapup.io/api/v1/call/historical_price_series","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"async":{"type":"boolean","description":"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."},"period":{"enum":["1mo","3mo","6mo","1y","2y","5y","10y","max"],"type":"string","description":"Look-back period. Default: 1y."},"ticker":{"type":"string","description":"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)."},"metrics":{"type":"array","items":{"enum":["open","high","low","close","volume","returns","volatility"],"type":"string"},"description":"Subset of fields to include (informational — all fields always returned)."},"adjusted":{"type":"boolean","description":"Adjust close prices for dividends and splits. Default: true."},"interval":{"enum":["1d","1wk","1mo"],"type":"string","description":"Bar interval. Default: 1d (daily)."}}},"responseSchema":{"type":"json","example":{"tool":"historical_price_series","result":{},"source":"rest-api"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GRsDVaWXGl1eGvhd1mi6Y","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical OHLCV price data and derived metrics for stocks, ETFs, crypto, futures, and indices over configurable look-back periods and bar intervals via Yahoo Finance.","exampleAgentPrompt":"Pull daily adjusted close prices, volume, and returns for AAPL over the last 2 years so I can run a backtest.","exampleUseCases":[{"title":"Volatility analysis for portfolio rebalancing","prompt":"Get me the last 5 years of weekly price data for QQQ, SPY, and TLT so I can calculate rolling volatility and decide if we should rebalance."},{"title":"Crypto momentum backtesting across timeframes","prompt":"Fetch daily and weekly OHLCV bars for Bitcoin and Ethereum over the past 3 years—I want to test a momentum strategy across both intervals."},{"title":"International stock price research and comparison","prompt":"Pull the last 10 years of monthly adjusted closes for Toyota, BMW, and ASML so I can compare long-term performance and dividend-adjusted returns across markets."}],"resultDescription":"A JSON object containing the tool name and a result payload with historical price bars for the requested ticker. Each bar includes open, high, low, close, and volume fields, plus optional derived metrics like daily returns and rolling volatility, covering the full requested look-back period at the specified interval. Prices are split- and dividend-adjusted by default.","failureModes":["Invalid or unrecognized ticker symbol returns an error or empty result","Unsupported interval/period combination may return an error","Yahoo Finance data unavailability for certain tickers or date ranges returns empty series","Network timeout for very long series; use async=true to avoid client timeout","Authentication failure (missing or invalid Bearer token) returns 401"],"whenToPreferThis":"Use this endpoint when you need structured historical OHLCV time-series data for equities, ETFs, indices, crypto, or futures across global exchanges. It supports wide look-back windows (up to max) and multiple bar intervals (daily, weekly, monthly), making it ideal for backtesting, charting, volatility analysis, and quantitative research. Prefer it over real-time quote endpoints when you need a historical series rather than a snapshot.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:48:00.845Z","isFirstParty":false}