Honeycluster Docs – Get CEX OHLCV candles for a single exchange

CEX

Get CEX OHLCV candles for a single exchange

get

/cex/exchanges/{exchangeId}/ohlcv

operationId: cex-historyByExchange

Returns one venue's OHLCV candles for an asset+base — same time-window / interval / limit semantics as /cex/ohlcv, but without cross-exchange aggregation. Useful for per-venue audit, identifying outliers, and powering venue-specific charts. Candles are returned in ascending time order.

Authorizations

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

Path Parameters

Name	Type	Default	Description
`exchangeId` required	string		Exchange identifier (e.g. `BINANCE_US`).

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
`exchangeId`	string	Echoed exchange identifier.
`asset`	string	Echoed asset symbol.
`base`	string	Echoed base currency.
`items`	object[]	Single venue's OHLCV candles in ascending bucket order. Empty when the venue has no data in the window.
`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

{
  "exchangeId": "string",
  "asset": "string",
  "base": "string",
  "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": []
}