Market Open Interest

GET/v1/hyperliquid/markets/oi

Returns the historical open-interest and funding-rate time series for a coin at the requested interval. open_interest is the sum of absolute signed position sizes across all users at each funding snapshot.

Each row also exposes the directional positioning split (long_size, short_size, net_position, plus long_positions and short_positions as user counts) and funding aggregates (funding_rate, total_funding, positive_funding, negative_funding) — useful for detecting crowded sides, funding pressure, and position flushes.

Query Parameters

Parameter	Description	Value
`coin` string	Hyperliquid coin identifier. Core perps have no prefix (`BTC`, `HYPE`); spot pairs use `@N` (`@107`); builder DEXs prefix the symbol with the DEX name (`xyz:SILVER`).	Required
`dex` string	DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (e.g. `xyz`, `cash`). New builder DEXs are added on Hyperliquid permissionlessly — call `/v1/hyperliquid/dexes` for the live set.
`interval` string	The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly). *Plan restricted. Default value: `1h` Accepted values: `1m`, `5m`, `10m`, `30m`, `1h`, `4h`, `1d`, `1w`	1h
`start_time` string	UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
`end_time` string	UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
`limit` integer	Number of items* returned in a single request. *Plan restricted. Default value: `10` Minimum value: `1` Maximum value: `1000`
`page` integer	Page number to fetch. Empty `data` array signifies end of results. Default value: `1` Minimum value: `1` Maximum value: `767465558638`

Potential Responses

Status	Description
200	Successful Response
400	Client side error
401	Authentication failed
403	Forbidden
404	Not found
500	Server side error