---
title: "Equity Price Candles"
method: GET
path: "/gateway/v1/equity/candles"
tags: ["Equity"]
---

# 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

- `symbol` string, required — US equity ticker symbol
- `interval` 'day' | 'week' | 'month' | 'year' — Candle interval
- `interval_multiplier` integer — Number of intervals represented by each candle
- `start_date` string — Inclusive start date in YYYY-MM-DD format; defaults to one year before end_date
- `end_date` string — Inclusive end date in YYYY-MM-DD format; defaults to the current date in US Eastern time

## Response `200`

OK

- DataObjectResponseEquityCandlesResponse
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` EquityCandlesResponse, required
    - `candles` EquityCandle[], nullable, required
      - `close` number, double, required — Closing price
      - `high` number, double, required — Highest price
      - `low` number, double, required — Lowest price
      - `open` number, double, required — Opening price
      - `timestamp` integer, required — Candle timestamp as Unix seconds
      - `volume` integer, required — Trading volume
    - `end_date` string
    - `interval` string, required
    - `interval_multiplier` integer, required
    - `latest_price` EquityLatestPrice, required
      - `day_change` number, double — Absolute change from the previous trading-day close
      - `day_change_percent` number, double — Percentage change from the previous trading-day close
      - `price` number, double, required — Latest traded price
      - `timestamp` integer, required — Latest-price timestamp as Unix seconds
    - `start_date` string
    - `symbol` string, required
  - `meta` ObjectResponseMeta, required
    - `cached` boolean, required — Whether this response was served from cache
    - `credits_used` integer, required — Credits deducted for this request
    - `empty_reason` string — Hint explaining why the data array is empty, when applicable

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) · [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/asksurf/asksurf-public-rest-api/revisions/4153a9cb5145/schema)