Markets and finance

Historical price candles

OHLCV candles for the symbols you name, one row per candle: symbol, date, open, high, low, close, adjusted close, volume, the interval it was cut at, the currency and the exchange.

Intervals run from 1 minute to 3 months, and the window is either a named range from 1 day to max or an explicit start and end date. Turning on events adds a row per dividend, with its amount, and a row per stock split, with its ratio. Works for stocks, ETFs, crypto pairs, forex pairs, indices and futures. One result, and one billable item, per row.

When to use it

Use when you need the series rather than a single snapshot: backtests, drawdown and volatility maths, correlations across symbols, charting, or total return work that needs dividends and splits. Rows here are candles, not symbols, so a year of daily data is about 252 rows per symbol and maxItems is the ceiling you set on the whole call. Two things follow from that and both are worth knowing before the first call: the ceiling is filled in symbol order, so a call that runs out of room returns nothing at all for the later symbols, which makes one symbol per call the right shape for a long series; and intraday intervals only reach as far back as Yahoo keeps them, roughly 30 days at 1 minute and 2 years at 1 hour, so an old window at a fine interval comes back short or empty. Use finance.quote for where a symbol stands right now and finance.screener to pick the symbols first. Figures come from Yahoo Finance's public feeds rather than from an exchange, so the most recent candle can be delayed or still forming.

Inputs

Historical price candles takes 8 fields, 1 of them required. Anything you leave out falls back to the tool's own default.

How to call it

Connect once and your agent can reach Historical price candles the same way it reaches everything else in the catalog. Add Goro as an MCP connector, or paste the setup line into an agent that reads skills.

Or plain HTTP

POST /v1/run

{
  "endpoint": "finance.history",
  "input": {
    "tickers": [
      "AAPL"
    ],
    "maxItems": 250,
    "operation": "historical"
  }
}