Equity Price Candles

GET/gateway/v1/equity/candles

Returns historical OHLCV candles and the latest traded price for a US-listed equity. Candles are ordered by timestamp ascending; historical data and the latest price use independent freshness windows.

Query Parameters

symbolstringrequired

US equity ticker symbol

Example: AAPL

intervalenum<string>

Candle interval

Available options:dayweekmonthyear

interval_multiplierinteger

Number of intervals represented by each candle

start_datestring

Inclusive start date in YYYY-MM-DD format; defaults to one year before end_date

Example: 2025-01-01

end_datestring

Inclusive end date in YYYY-MM-DD format; defaults to the current date in US Eastern time

Example: 2025-12-31

Equity Price Candles

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/equity/candles?symbol=AAPL&start_date=2025-01-01&end_date=2025-12-31', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataObjectResponseEquityCandlesResponse.json",
  "data": {
    "candles": [
      {
        "close": 123,
        "high": 123,
        "low": 123,
        "open": 123,
        "timestamp": 123,
        "volume": 123
      }
    ],
    "end_date": "<string>",
    "interval": "<string>",
    "interval_multiplier": 123,
    "latest_price": {
      "day_change": 123,
      "day_change_percent": 123,
      "price": 123,
      "timestamp": 123
    },
    "start_date": "<string>",
    "symbol": "<string>"
  },
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>"
  }
}