POST
/
4f8d8f4040bdacd1577bff8058438274
/
info
info (liquidatable)
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "liquidatable",
  "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"
}'
{
  "liquidatable": true,
  "leverage": "<string>",
  "marginUsed": "<string>",
  "marginRemaining": "<string>",
  "accountValue": "<string>",
  "totalRawUsd": "<string>",
  "totalNtlPos": "<string>"
}
The info endpoint with type: "liquidatable" checks whether a user’s positions are currently at risk of liquidation on the Hyperliquid exchange. This endpoint provides critical risk management information including liquidation status, leverage ratios, margin usage, and account health metrics.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

Request body

  • type (string, required) — The request type. Must be "liquidatable" to check user’s liquidation status.
  • user (string, required) — Address in 42-character hexadecimal format (e.g., 0x31ca8395cf837de08b24da3f660e77761dfb974b).

Response

The response is an object containing liquidation status and risk metrics:

Liquidation status fields

  • liquidatable (boolean) — Whether the user’s positions are currently liquidatable:
    • true — Positions are at risk and may be liquidated
    • false — Positions are healthy and not at liquidation risk

Risk metrics (optional fields)

  • leverage (string) — Current effective leverage ratio of the user’s positions
  • marginUsed (string) — Amount of margin currently used for open positions
  • marginRemaining (string) — Amount of available margin before liquidation threshold
  • accountValue (string) — Total account value including unrealized profit and loss
  • totalRawUsd (string) — Total raw USD value of the account before adjustments
  • totalNtlPos (string) — Total notional position value across all assets

Understanding liquidation risk

Liquidation occurs when:
  • Account leverage exceeds maximum allowed ratios
  • Margin requirements are not met due to adverse price movements
  • Account value falls below maintenance margin requirements
Risk levels:
  • Safe: liquidatable: false with sufficient margin remaining
  • At Risk: liquidatable: true indicating immediate liquidation danger
  • Critical: High leverage with minimal margin remaining

Example request

Shell
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"type": "liquidatable", "user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"}' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info

Use case

The info endpoint with type: "liquidatable" is essential for trading applications that need to:
  • Risk monitoring: Continuously monitor account health and liquidation risk
  • Alert systems: Trigger warnings when positions approach liquidation thresholds
  • Position management: Make informed decisions about position sizing and leverage
  • Automated trading: Implement risk management rules in trading bots
  • Portfolio dashboards: Display real-time risk metrics and account health
  • Margin management: Calculate available margin for new positions
  • Liquidation protection: Automatically reduce positions when risk is high
  • Risk analytics: Track leverage ratios and margin utilization over time
  • Trading interfaces: Show visual indicators for account risk levels
  • Compliance monitoring: Ensure positions stay within risk parameters
  • Emergency protocols: Trigger emergency position closures when necessary
  • Performance analysis: Understand the relationship between leverage and returns
This endpoint is critical for any serious trading application, as it provides the real-time risk assessment needed to prevent liquidations and manage portfolio risk effectively on the Hyperliquid exchange.

Body

application/json

Response

200 - application/json

Liquidation status information for the user

Information about user's liquidation status and risk metrics