Skip to main content
GET
/
candles
Get market candles
curl --request GET \
  --url https://api.coincap.io/v2/candles \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "open": "0.031",
      "high": "0.035",
      "low": "0.030",
      "close": "0.032",
      "volume": "100",
      "period": 1528410925604
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
exchange
string
required

Exchange ID.

Example:

"poloniex"

​
interval
enum<string>
required

Candle interval (e.g., m1, m5, m15, etc.).

Available options:
m1,
m5,
m15,
m30,
h1,
h2,
h4,
h8,
h12,
d1,
w1
Example:

"h8"

​
baseId
string
required

Unique identifier for the base asset.

Example:

"ethereum"

​
quoteId
string
required

Unique identifier for the quote asset.

Example:

"bitcoin"

​
start
integer

Start time in UNIX milliseconds.

Example:

1528410925604

​
end
integer

End time in UNIX milliseconds.

Example:

1528411045604

Response

200 - application/json

Historical market candles.

​
data
object[]