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

Read-only preview

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

Quickstart

Preview Hyperliquid fills through the market activity feed. Start with BTC fills, then swap in any supported coin, DEX, or user address from the endpoint catalog below.

Website

No API key on this team yet — sample shows <YOUR_JWT> placeholder.

cURL

1curl 'https://token-api.service.pinax.network/v1/hyperliquid/markets/activity?coin=BTC&limit=10&page=1' \
2  -H 'Authorization: Bearer <YOUR_JWT>' \
3  -H 'Accept: application/json'

Hyperliquid Markets

Market Liquidations

PREVIEW

Returns one row per liquidation event, aggregated across the multiple fills that walk the book during a liquidation. Only the liquidated user's side is returned — counterparty fills are excluded.

Each row surfaces the coin, liquidated user, transaction hash, liquidation kind (CROSS_LONG, ISOLATED_SHORT, and others), total size and notional, size-weighted average fill price, the mark price at liquidation, and the liquidation method reported by the venue (backstop and others).

Filter by coin, dex, and/or liquidated_user — filters compose additively. Sort by notional (default — largest events first) or time (most recent first).

GET

https://token-api.service.pinax.network/v1/hyperliquid/markets/liquidations

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

Optional parameters

Name	Type	Description
coin query	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`). e.g. BTC
dex query	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.
liquidated_user query	string · evm-address	Filter by address e.g. 0xd8da6bf26964af9d7eed9e03e53415d37aa96045
sort_by query	Enum · 2	notionaltime
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-02-06 00:19:53",
      "coin": "BTC",
      "market_name": "BTC",
      "dex": "perps",
      "liquidated_user": "0x7ba283114573bde6fd304ad7b188a763e5402a52",
      "event_hash": "0x37cd3a3ffeb5bee739460434c180bf000008522599b8ddb9db95e592bdb998d1",
      "direction": "LIQUIDATED_CROSS_LONG",
      "liquidation_kind": "CROSS_LONG",
      "fills": 2,
      "total_size": 0.2203,
      "notional": 13116.86,
      "avg_fill_price": 59540.9,
      "mark_price": 60114,
      "liquidation_method": "backstop",
      "total_fees": 0
    }
  ]
}