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
{
  "candles": [
    {
      "start": "1639508050",
      "low": "140.21",
      "high": "140.21",
      "open": "140.21",
      "close": "140.21",
      "volume": "56437345"
    }
  ]
}

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,
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.