API

How to use the HertzFlow Oracle Price API.

The HertzFlow Oracle Price API is a public REST service for reading the latest oracle prices of all supported tokens on BNB Smart Chain (BSC).

Base URLs

Network	Base URL
BSC Mainnet	https://oracle-aggregator.hertzflow.xyz
BSC Testnet	https://oracle-aggregator.testnet.htzfl.link

All routes below are appended to the base URL. The two networks serve the same endpoint over their own symbol set.

Authentication

No authentication, API key, or authorization header is required. All endpoints are public GET requests.

Response format

Responses are plain JSON with a top-level data object — there is no code/msg envelope:

{
  "data": {
    "prices": [
      {
        "symbol": "BTC/USD",
        "bsc_token_addr": "0x2d8f28f05113c2dc0a17ebbba60d8f72318bdb1f",
        "price": "79816.7150025",
        "timestamp": 1787905129
      }
    ]
  }
}

Prices are human-readable decimal strings in USD, so no scaling is needed before display. Timestamps are Unix seconds.

Errors

Case	Response
Missing or invalid query parameters	400 with {"code":"INVALID_PARAMS_ERROR","error":"..."} — note that code is a string enum, not a number
Unknown path	404 with the plain-text body 404 page not found

Quick start

Fetch the latest prices for every supported token on mainnet:

curl "https://oracle-aggregator.hertzflow.xyz/api/v1/latestPrice?get_all=true"

Example response (truncated):

{
  "data": {
    "prices": [
      {
        "symbol": "MRVL/USD",
        "bsc_token_addr": "0x663de62a4be589533b30b08a55009ce27c75c003",
        "price": "221.83497",
        "timestamp": 1787904899
      },
      {
        "symbol": "ETH/USD",
        "bsc_token_addr": "0x2c08e4b0442381bb2f6e70943c94f991345be236",
        "price": "2497.327261755814",
        "timestamp": 1787904899
      }
    ]
  }
}

For the full endpoint reference, see API Reference.