API

HertzFlow provides REST APIs for accessing market data, prices, and historical trading information.

Base URLs

BSC Testnet

Service	Base URL
Kline Query	https://kline-query.testnet.htzfl.link
Oracle Aggregator	https://oracle-aggregator.testnet.htzfl.link

API Endpoints

Market Data

API	Endpoint	Description
Kline	/api/v1/historyKLines	Historical candlestick/OHLCV data
Latest Price	/api/v1/latestPrice	Current oracle prices for all tokens

Authentication

All endpoints are public and do not require authentication.

Rate Limits

Tier	Requests/minute
Public	60

Response Format

Kline API

{
  "code": 200,
  "data": { ... },
  "is_success": true,
  "msg": ""
}

Price API

{
  "data": {
    "prices": [ ... ]
  }
}

Supported Trading Pairs

Symbol	Description
ETH/USD	Ethereum
BTC/USD	Bitcoin
BNB/USD	BNB
DOGE/USD	Dogecoin

Above listed trading pairs are the ones currently supported on testnet environment. More pairs will be supported soon.

Common Parameters

Parameter	Type	Description
symbol	string	Trading pair symbol (e.g., ETH/USD)
interval	string	Kline interval (1m, 5m, 15m, 1h, 4h, 1d)
limit	number	Number of results to return

Error Handling

Error responses include an HTTP status code and message:

Code	Description
200	Success
400	Invalid request parameters
404	Resource not found
500	Internal server error

Quick Start

Get Latest ETH Price

curl "https://oracle-aggregator.testnet.htzfl.link/api/v1/latestPrice?get_all=true" | jq '.data.prices[] | select(.symbol == "ETH/USD")'

Get ETH Klines (15m)

curl "https://kline-query.testnet.htzfl.link/api/v1/historyKLines?symbol=ETH/USD&interval=15m&limit=10"