ASasksurf
Equity

Equity Price Candles

Changed on

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.

get/gateway/v1/equity/candles

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

symbolstring required

US equity ticker symbol

Example:AAPL
interval'day' | 'week' | 'month' | 'year'

Candle interval

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

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataObjectResponseEquityCandlesResponse.json"
}

Changes