Pinax
    Hyperliquid perpetual exchange data endpoints, plus API documentation and monitoring.
    Resources & endpoints
    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

    NameTypeDescription
    coin
    query
    		stringHyperliquid 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 · 9DEX 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-addressFilter by address
    Single value or array of values* (separate multiple values with ,)
    *Plan restricted.
    e.g. 0xd8da6bf26964af9d7eed9e03e53415d37aa96045
    direction
    query
    		Enum · 18Restrict 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
    		DatetimeUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
    end_time
    query
    		DatetimeUNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
    limit
    query
    		integerNumber of items* returned in a single request.
    *Plan restricted.
    page
    query
    		integerPage 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
    }
  ]
}