---
title: "Get Market Candle"
method: GET
path: "/v1/markets/{symbol}/candle"
tags: ["market-data"]
---

# Get Market Candle

`GET /v1/markets/{symbol}/candle`

## Request

- Base URL: `https://api.exchange.bullish.com/trading-api`
- URL: `https://api.exchange.bullish.com/trading-api/v1/markets/{symbol}/candle`
- Auth: none required
- TypeScript: <https://skmtc.dev/bullish/apis/bullish-trading-api/docs/v1/markets/:symbol/candle/get.ts> (a function with typed inputs; its response is checked against the schema)

Get Current OHLCV Candle by Market Symbol
- [supports pagination](/rest/general/pagination)
- filtering on `createdAtDatetime`, `createdAtTimestamp` requires additional keywords, [see filtering support](/rest/general/filtering)

**Ratelimited:** `False`

## Path parameters

- `symbol` string, required: market symbol. E.g. `BTCUSDC`

## Query parameters

- `createdAtDatetime[gte]` string, date-time, required: ISO 8601 with millisecond as string
- `createdAtDatetime[lte]` string, date-time, required: ISO 8601 with millisecond as string
- `timeBucket` '1m' | '5m' | '30m' | '1h' | '6h' | '12h' | '1d', required

## Response `200`

OK

- OHLCVCandle[]
  - `open` string: see [asset value](/rest/general/price-quantity-precision) format
  - `high` string: see [asset value](/rest/general/price-quantity-precision) format
  - `low` string: see [asset value](/rest/general/price-quantity-precision) format
  - `close` string: see [asset value](/rest/general/price-quantity-precision) format
  - `volume` string: see [asset value](/rest/general/price-quantity-precision) format
  - `createdAtTimestamp` string, string: unsigned 64 bit integer value which is the number of milliseconds since EPOCH expressed as string
  - `createdAtDatetime` string, date-time: ISO 8601 with millisecond as string
  - `publishedAtTimestamp` string, string: unsigned 64 bit integer value which is the number of milliseconds since EPOCH expressed as string

## Other responses

- `404`: Resource Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/bullish/apis/bullish-trading-api.md) - [All operations](https://skmtc.dev/bullish/apis/bullish-trading-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bullish/apis/bullish-trading-api/revisions/df5d69ccedcf?raw)