Hyperliquid perpetual exchange data endpoints, plus API documentation and monitoring.

Resources & endpoints

Read-only preview

You're browsing the public OpenAPI spec. Sign in to send live requests with your team's API key.

Hyperliquid Markets

Market Open Interest

PREVIEW

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.

GET

https://api.pinax.network/v1/hyperliquid/markets/oi

Requires bearer token — sign in to inject your team’s key.

Required parameters

Name	Type	Description
coinrequired query	string	Hyperliquid coin id. Perps: `BTC`. Spot: `@N` (`@107`). Builder DEXs: `xyz:SILVER`. Outcome coins (`#N`) are rejected — use `/v1/hyperliquid/outcomes/`. Single value or array of values (separate multiple values with `,`) *Plan restricted. e.g. BTC

Optional parameters

Name	Type	Description
dex query	Enum · 9	DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (`xyz`, `cash`, …). Outcome markets are served separately under `/v1/hyperliquid/outcomes/`. Single value or array of values (separate multiple values with `,`) *Plan restricted. perpsspotxyzcashkmhynaflxvntlpara
interval query	Enum · 8	The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly). *Plan restricted. 1m5m10m30m1h4h1d1w
start_time query	Datetime	UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
end_time query	Datetime	UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
limit query	integer	Number of items* returned in a single request. *Plan restricted.
page query	integer	Page number to fetch. Empty `data` array signifies end of results.

Response

200 OK

{
  "data": [
    {
      "timestamp": "2026-04-30 23:00:00",
      "coin": "BTC",
      "market_name": "BTC",
      "dex": "perps",
      "interval_min": 60,
      "open_interest": 27984.45,
      "net_position": 0,
      "long_size": 13992.23,
      "short_size": -13992.23,
      "long_positions": 16381,
      "short_positions": 14034,
      "funding_rate": -0.0000154515,
      "total_funding": -0.001199,
      "positive_funding": 16482.55,
      "negative_funding": -16482.55,
      "funding_events": 30415
    }
  ]
}