Skip to main content
POST
Run a read-only SQL query
Every table with its start date, the limits per plan and eight tested example queries (candles from trades, taker flow, liquidations, funding, transfers, PnL) are in the Hyperliquid SQL guide.

Authorizations

Authorization
string
header
required

Ironflow API key, format if_xxxx. Free keys at https://ironflow.sh/key. Optional on read endpoints.

Body

application/json
sql
string
required

One read-only ClickHouse statement.

Maximum string length: 20000
max_rows
integer

Most rows to return. Defaults to, and is capped at, the tier limit.

Required range: x >= 1

Response

Query result.

columns
object[]
required
rows
any[][]
required

Positional rows in columns order. Numbers stay JSON numbers; times are UTC strings.

row_count
integer
required
truncated
boolean
required

More rows existed than max_rows.

stats
object
required
limits
object
required
budget_remaining_seconds
number
required