Skip to main content

Hyperliquid Liquidations, Funding, Positions & Leverage API

This page covers the perp risk cubes: PerpLiquidations, PerpFundings, CurrentPositions and TraderLeverageUpdates.

API Key Required

To query or stream data outside the Bitquery IDE, you need an API access token.

Follow the steps here: How to generate Bitquery API token ➤

Liquidations​

Each liquidation includes the liquidated user, the Method (market for open-market liquidation, backstop when the backstop vault takes over), the mark price at liquidation and the actual execution.

Run it in the IDE: Hyperliquid Liquidations ➤

query {
  Hyperliquid {
    PerpLiquidations(limit: {count: 50}, orderBy: {descending: Block_Time}) {
      Block { Time }
      Liquidation {
        Market { Symbol Kind }
        Method MarkPx Liquidator LiquidatedUser
        Execution { Price Size Side Direction Hash }
        Position { Leverage IsCross Side SizeBefore }
        Fees { Fee FeeToken }
      }
    }
  }
}

Real-time liquidation alerts​

Run it in the IDE: Hyperliquid Liquidations Stream ➤

subscription {
  Hyperliquid {
    PerpLiquidations {
      Block { Time }
      Liquidation {
        Market { Symbol }
        Method MarkPx LiquidatedUser
        Execution { Price Size Side }
        Position { Leverage IsCross SizeBefore }
      }
    }
  }
}

Funding payments​

PerpFundings records per-trader funding transfers at each hourly funding tick: the signed Amount (negative = the trader paid funding), the funding Rate applied and the position Size it applied to.

Run it in the IDE: Hyperliquid Funding Payments ➤

query {
  Hyperliquid {
    PerpFundings(limit: {count: 50}, orderBy: {descending: Block_Time}) {
      Block { Time }
      Funding {
        Market { Symbol Kind }
        Amount Rate Size
        Trader { Address }
      }
    }
  }
}

Filter to one wallet with where: {Funding: {Trader: {Address: {is: "0x..."}}}} to compute its total funding paid/received.

Current positions​

CurrentPositions is a state cube with the currently open perp positions: signed Size (negative = short, empty = flat), leverage, margin mode, accumulated Funding and RealizedPnl.

Run it in the IDE: Hyperliquid Current Positions ➤

query {
  Hyperliquid {
    CurrentPositions(
      limit: {count: 50}
      orderBy: {descending: LastTime}
      where: {Market: {Symbol: {is: "BTC"}}}
    ) {
      LastBlock
      LastTime
      Market { Symbol Kind }
      Position { Size Leverage IsCross Funding RealizedPnl }
      Trader { Address }
    }
  }
}

Swap the filter to where: {Trader: {Address: {is: "0x..."}}} to get every open position of one trader.

Leverage updates​

TraderLeverageUpdates fires whenever a trader changes leverage or switches between cross and isolated margin on a market.

Run it in the IDE: Hyperliquid Leverage Updates ➤

query {
  Hyperliquid {
    TraderLeverageUpdates(limit: {count: 50}, orderBy: {descending: Block_Time}) {
      Block { Time }
      LeverageUpdate {
        Leverage IsCross
        Market { Symbol }
        Trader { Address }
      }
    }
  }
}

All four cubes stream over WebSocket with the same shape — change query to subscription and drop limit/orderBy.