Hyperliquid Open Positions and Liquidation Prices (by Wallet Address)

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "minLength": 1,
      "description": "The wallet's 0x EVM address."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "address": {
          "type": "string",
          "description": "Echoes the queried wallet address."
        },
        "positions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "side": {
                "type": "string",
                "description": "long or short."
              },
              "size": {
                "type": "number",
                "description": "Position size in the asset; negative for a short."
              },
              "symbol": {
                "type": "string",
                "description": "The market symbol."
              },
              "mark_price": {
                "type": "number",
                "description": "Current mark price."
              },
              "cum_funding": {
                "type": "object",
                "properties": {
                  "all_time": {
                    "type": "number"
                  },
                  "since_open": {
                    "type": "number"
                  },
                  "since_change": {
                    "type": "number"
                  }
                },
                "description": "Cumulative funding, in USD."
              },
              "entry_price": {
                "type": "number",
                "description": "Average entry price."
              },
              "margin_used": {
                "type": "number",
                "description": "Margin used, in USD."
              },
              "max_leverage": {
                "type": "number",
                "description": "The market's maximum leverage."
              },
              "leverage_type": {
                "type": "string",
                "description": "The margin mode, e.g. cross."
              },
              "leverage_value": {
                "type": "number",
                "description": "The leverage applied."
              },
              "position_value": {
                "type": "number",
                "description": "Position value, in USD."
              },
              "unrealized_pnl": {
                "type": "number",
                "description": "Unrealized PnL, in USD."
              },
              "return_on_equity": {
                "type": "number",
                "description": "Return on equity, as a fraction."
              },
              "liquidation_price": {
                "type": "number",
                "description": "Estimated liquidation price."
              },
              "distance_to_liquidation": {
                "type": "number",
                "description": "How far the liquidation price is from the mark price, as a fraction of the mark price."
              }
            }
          },
          "description": "One entry per open position."
        },
        "timestamp": {
          "type": "number",
          "description": "Snapshot time, as Unix seconds."
        },
        "margin_ratio": {
          "type": "number",
          "description": "Maintenance margin used divided by account value, as a fraction."
        },
        "withdrawable": {
          "type": "number",
          "description": "The withdrawable amount, in USD."
        },
        "account_value": {
          "type": "number",
          "description": "The account's value, in USD."
        },
        "total_margin_used": {
          "type": "number",
          "description": "Total margin used, in USD."
        },
        "total_notional_pos": {
          "type": "number",
          "description": "Total notional value of open positions, in USD."
        },
        "cross_maintenance_margin_used": {
          "type": "number",
          "description": "Cross-margin maintenance margin used, in USD."
        }
      }
    }
  },
  "description": "A wallet's open perpetual positions and cross-margin summary."
}