---
title: "List Candles"
method: GET
path: "/v2/candles/{symbol}/{time_frame}"
tags: ["Market Data"]
---

# List Candles

`GET /v2/candles/{symbol}/{time_frame}`

## Request

- Base URL: `https://api.gemini.com`
- URL: `https://api.gemini.com/v2/candles/{symbol}/{time_frame}`
- Auth: none declared

This endpoint retrieves time-intervaled data for the provided symbol.

## Path parameters

- `symbol` string, required
- `time_frame` '1m' | '5m' | '15m' | '30m' | '1h' | '6h' | '1d', required

## Response `200`

The response will be an array of arrays

- Candle[]
  - number[]

## Other responses

- `400`: Bad request - malformed request or invalid parameters
- `404`: Resource not found
- `429`: Too many requests - you have exceeded the rate limit
- `500`: Internal server error

---

[API](https://skmtc.dev/gemini/apis/rest-api.md) - [All operations](https://skmtc.dev/gemini/apis/rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gemini/apis/rest-api/revisions/24979792d748?raw)