Honeycluster Docs – Get oracle price history

oracles

Get oracle price history

get

/oracles/price-history

operationId: oracle-getPriceHistory

Returns the price sample history for a given oracle, ordered by sample time (newest first). The cursor is the ledger index of the last item on the previous page, so pagination is stable even when multiple samples share a timestamp.

Authorizations

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

Query Parameters

Name	Type	Default	Description
`cursor`	string
`limit`	integer	`20`
`oracleId` required	string		Oracle identifier to fetch price history for.

Responses

200

application/json

Successful response

Field	Type	Description
`items`	object[]	Page of results.
`items[].oracleId`	string	Parent oracle_id.
`items[].baseAsset`	string	Base asset code.
`items[].quoteAsset`	string	Quote asset code.
`items[].assetPrice`	string	Price value as a decimal string, scaled by `scale`.
`items[].scale`	integer	Decimal scale factor — apply as `assetPrice / 10^scale` to get the human value.
`items[].ledgerIndex`	integer	Ledger sequence of this price update.
`items[].txHash`	string	Transaction hash that produced this update.
`items[].sampledAt`	integer	Ledger close time of the update, Unix-seconds.
`nextCursor`	object	Cursor to fetch the next page, or null if this is the last page.

Example

Json

{
  "items": [
    {
      "oracleId": "string",
      "baseAsset": "string",
      "quoteAsset": "string",
      "assetPrice": "string",
      "scale": 0,
      "ledgerIndex": 0,
      "txHash": "string",
      "sampledAt": 1745798400
    }
  ],
  "nextCursor": "string"
}

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