Honeycluster Docs – Batch fetch raw OHLCV candles for many XRPL tokens

XRPL

Batch fetch raw OHLCV candles for many XRPL tokens

post

/xrpl/ohlcv/batch

operationId: xrpl-ohlcvBatch

POST batch variant of /xrpl/ohlcv. Body: { tokens: [...], interval, startTime, endTime, limit } (max 50 tokens; each entry is {tokenSlug} or {currency, issuer}). Returns one row per requested token as { currency, issuer, pair, candles: [...] }; tokens with no matching XRPL pair surface as pair: null, candles: [] so one bad token doesn't fail the whole batch. Time-window / interval / limit are shared across the batch.

Authorizations

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

Request Body

application/json

required

Field	Type	Default	Description
`tokens` required	object[]		Tokens to fetch candles for. Each entry is `{tokenSlug}` or `{currency, issuer}`. Max 50 per request.
`interval`	enum<string>	`"1h"`	OHLCV candle interval. Defaults to `1h`. Available `1m3m5m15m30m1h2h4h`
`startTime`	integer		Inclusive lower bound for candle time, Unix-seconds. Defaults to `endTime − (interval × limit)`.
`endTime`	integer		Exclusive upper bound for candle time, Unix-seconds. Defaults to the current server time.
`limit`	integer	`500`	Per-token maximum number of candles to return (1–1000). Defaults to 500.

Example

Json

{
  "tokens": [
    {
      "tokenSlug": "string"
    }
  ],
  "interval": "1h",
  "startTime": 1745798400,
  "endTime": 1745798400,
  "limit": 500
}

Responses

200

application/json

Successful response

Field	Type	Description
`items`	object[]	One entry per requested token, in request order.
`items[].currency`	string	Echoed currency code.
`items[].issuer`	object	Echoed issuer, or `null` for XRP.
`items[].pair`	object	Resolved trade pair, or `null` when no pair was found for the token.
`items[].candles`	object[]	OHLCV candles for the token, ascending bucket order. Empty when no pair / data exists in the window.
`items[].candles[].tradePairId`	string	Trade pair identifier (UUID v4).
`items[].candles[].bucket`	integer	Start of the candle interval, Unix-seconds.
`items[].candles[].open`	string	Opening price of the interval (decimal string).
`items[].candles[].high`	string	Highest price seen in the interval (decimal string).
`items[].candles[].low`	string	Lowest price seen in the interval (decimal string).
`items[].candles[].close`	string	Closing price of the interval (decimal string).
`items[].candles[].volume`	string	Total volume traded in the interval (decimal string).
`items[].candles[].tradeCount`	number	Number of trades that make up the candle.

Example

Json

{
  "items": [
    {
      "currency": "string",
      "issuer": "string",
      "pair": {
        "id": "00000000-0000-0000-0000-000000000000",
        "baseCurrency": "string",
        "baseIssuer": "string",
        "quoteCurrency": "string",
        "quoteIssuer": "string",
        "createdAt": "string",
        "updatedAt": "string"
      },
      "candles": [
        {
          "tradePairId": "3c4a3de8-4218-400c-8c55-87dc27206753",
          "bucket": 1745712000,
          "open": "0.512",
          "high": "0.518",
          "low": "0.509",
          "close": "0.514",
          "volume": "128450.32",
          "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": []
}

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": []
}