Honeycluster Docs – Get CEX OHLCV candles

CEX

Get CEX OHLCV candles

get

/cex/ohlcv

operationId: cex-history

Returns OHLCV candles for a single asset+base from CEX price feed data, aggregated across all venues per bucket (sourced from TimescaleDB continuous aggregates). Includes VWAP alongside standard OHLCV. Candles are returned in ascending time order. endTime defaults to now, startTime defaults to endTime − (interval × limit). Use /cex/exchanges/{exchangeId}/ohlcv for a single venue's raw candles.

Authorizations

Name	Location	Details
`BearerAuth`	Authorization header · bearer	JWT issued by the Honeycluster auth service for the `oracle` audience. Present as `Authorization: Bearer <token>`.

Query Parameters

Name	Type	Default	Description
`asset` required	string		Asset symbol to query (e.g. `XRP`).
`base`	string	`"USD"`
`interval`	enum<string>	`"1h"`	Available `1m3m5m15m30m1h2h4h`
`startTime`	integer
`endTime`	integer
`limit`	integer	`500`

Responses

200

application/json

Successful response

Field	Type	Description
`items`	object[]	OHLCV candles in ascending bucket order.
`items[].asset`	string	Asset symbol.
`items[].base`	string	Base currency.
`items[].bucket`	integer	Candle start time, Unix-seconds.
`items[].open`	object	Opening price (decimal string), or `null` when only ticker-derived close is available.
`items[].high`	object	Highest price (decimal string), or `null` when only ticker-derived close is available.
`items[].low`	object	Lowest price (decimal string), or `null` when only ticker-derived close is available.
`items[].close`	string	Closing price (decimal string).
`items[].volume`	object	Total volume in the interval, or `null` when only ticker-derived close is available.
`items[].vwap`	object	Volume-weighted average price.
`items[].tradeCount`	number	Number of trades aggregated into the candle.

Example

Json

{
  "items": [
    {
      "asset": "XRP",
      "base": "USD",
      "bucket": 1745712000,
      "open": "0.512",
      "high": "0.518",
      "low": "0.509",
      "close": "0.514",
      "volume": "128450.32",
      "vwap": 0.5135,
      "tradeCount": 312
    }
  ]
}

400

application/json

Invalid input data

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

401

application/json

Authorization not provided

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}

403

application/json

Insufficient access

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}

404

application/json

Not found

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}

500

application/json

Internal server error

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}