GET
/
api
/
v3
/
brokerage
/
products
/
{product_id}
/
candles
Get Product Candles
curl --request GET \
  --url https://api.coinbase.com/api/v3/brokerage/products/{product_id}/candles \
  --header 'Authorization: Bearer <token>'
{
  "candles": [
    {
      "start": "1639508050",
      "low": "140.21",
      "high": "140.21",
      "open": "140.21",
      "close": "140.21",
      "volume": "56437345"
    }
  ]
}

Authorizations

Authorization
string
header
required

A JWT signed using your CDP API Key Secret, encoded in base64. Refer to the Creating API Keys section of our Coinbase App Authentication docs for information on how to generate your Bearer Token.

Path Parameters

product_id
string
required

The trading pair (e.g. 'BTC-USD').

Query Parameters

start
string
required

The UNIX timestamp indicating the start of the time interval.

end
string
required

The UNIX timestamp indicating the end of the time interval.

granularity
enum<string>
default:UNKNOWN_GRANULARITY
required

The timeframe each candle represents.

Available options:
UNKNOWN_GRANULARITY,
ONE_MINUTE,
FIVE_MINUTE,
FIFTEEN_MINUTE,
THIRTY_MINUTE,
ONE_HOUR,
TWO_HOUR,
FOUR_HOUR,
SIX_HOUR,
ONE_DAY
limit
integer

The number of candle buckets to be returned. By default, returns 350 (max 350).

Response

200
application/json

A successful response.

The response is of type object.