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.

Guide

Website

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

1curl 'https://api.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 Activity

PREVIEW

Returns a chronological fill feed, filterable by coin, dex, and/or user. Each row is a single fill carrying price, size, side (BID or ASK), directional intent (OPEN_LONG, CLOSE_SHORT, LIQUIDATED_CROSS_LONG, AUTO_DELEVERAGING, and others), closed PnL, fees (negative values represent maker rebates), and order-level metadata (order_id, client_order_id, twap_id, crossed).

For balance-changing events on a user (deposits, withdrawals, funding payments, vault flows), use /v1/hyperliquid/users/activity.

At least one of coin, dex, or user is required. Filters compose additively; pass any combination to narrow further. A mismatched pair (e.g. coin=cash:TSLA&dex=xyz) returns empty.

Defaults to the last 24 hours when no time range is specified. Pass start_time and end_time to query older data.

GET

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

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

Optional parameters

Name	Type	Description
coin 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
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
user query	string · evm-address	Filter by address Single value or array of values* (separate multiple values with `,`) *Plan restricted. e.g. 0xd8da6bf26964af9d7eed9e03e53415d37aa96045
direction query	Enum · 18	Restrict by perp/spot direction tag. Includes `BUY`/`SELL` matches, perp `OPEN_`/`CLOSE_` transitions, forced liquidations, delisted-market `SETTLEMENT`, and housekeeping flows. Omit for all. Single value or array of values* (separate multiple values with `,`) *Plan restricted. BUYSELLOPEN_LONGCLOSE_LONGOPEN_SHORTCLOSE_SHORTLONG_TO_SHORTSHORT_TO_LONGSPOT_DUST_CONVERSIONLIQUIDATED_CROSS_LONGLIQUIDATED_CROSS_SHORTLIQUIDATED_ISOLATED_LONGLIQUIDATED_ISOLATED_SHORTAUTO_DELEVERAGINGSETTLEMENTNET_CHILD_VAULTSBACKSTOP_BORROW_LIQUIDATIONPARTIAL_BORROW_LIQUIDATION e.g. BUY
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": [
    {
      "block_num": 979136485,
      "timestamp": "2026-04-30 23:26:59",
      "transaction_hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "transaction_id": 494766926007210,
      "coin": "BTC",
      "market_name": "BTC",
      "dex": "perps",
      "user": "0xd8592afc09c864df215d8012122aed08e4ae453f",
      "side": "ASK",
      "direction": "OPEN_SHORT",
      "price": 76257,
      "size": 0.01424,
      "notional": 1085.9,
      "start_position": "-0.60385",
      "closed_pnl": 0,
      "fee": 0.380064,
      "fee_token": "USDC",
      "order_id": 405525134401,
      "client_order_id": "",
      "twap_id": 1781070,
      "crossed": true
    }
  ]
}