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.

    GuideWebsite
    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 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://api.pinax.network/v1/hyperliquid/markets/liquidations
    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
    liquidated_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 · 7Restrict by liquidation kind. LIQUIDATED_CROSS_* / LIQUIDATED_ISOLATED_* cover margin-based liquidations; AUTO_DELEVERAGING is HL ADL; *_BORROW_LIQUIDATION covers borrow-side. Omit for all.
    Single value or array of values* (separate multiple values with ,)
    *Plan restricted.
    LIQUIDATED_CROSS_LONGLIQUIDATED_CROSS_SHORTLIQUIDATED_ISOLATED_LONGLIQUIDATED_ISOLATED_SHORTAUTO_DELEVERAGINGBACKSTOP_BORROW_LIQUIDATIONPARTIAL_BORROW_LIQUIDATION
    e.g. LIQUIDATED_CROSS_LONG
    sort_by
    query
    		Enum · 2
    notionaltime
    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": 880714128,
      "timestamp": "2026-02-06 00:19:53",
      "event_hash": "0x37cd3a3ffeb5bee739460434c180bf000008522599b8ddb9db95e592bdb998d1",
      "coin": "BTC",
      "market_name": "BTC",
      "dex": "perps",
      "liquidated_user": "0x7ba283114573bde6fd304ad7b188a763e5402a52",
      "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
    }
  ]
}