Hyperliquid Trading Performance by Wallet

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "minLength": 1,
      "description": "Wallet address: a 0x EVM address or an ENS name (e.g. vitalik.eth). Solana addresses are not supported."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "address": {
          "type": "string",
          "description": "The wallet this summary is for -- echoes the requested address, or the resolved 0x address when an ENS name was given (observed 'vitalik.eth' resolving to a 0x address)."
        },
        "partial": {
          "type": "boolean",
          "description": "Whether the summary is a partial snapshot; typically false."
        },
        "watermark": {
          "type": "integer",
          "description": "Unix timestamp tied to account state (e.g. 1790034582 for an active whale account, 0 for a flat account); exact meaning not documented."
        },
        "performance": {
          "type": "object",
          "properties": {
            "fees": {
              "type": "number",
              "description": "Cumulative fees (negative, a deduction)."
            },
            "wins": {
              "type": "integer",
              "description": "Number of winning trades."
            },
            "losses": {
              "type": "integer",
              "description": "Number of losing trades."
            },
            "trades": {
              "type": "integer",
              "description": "Total number of closed trades."
            },
            "avg_win": {
              "type": "number",
              "description": "Average winning-trade PnL."
            },
            "net_pnl": {
              "type": "number",
              "description": "Realized net profit = gross minus fees."
            },
            "avg_loss": {
              "type": "number",
              "description": "Average losing-trade PnL (negative)."
            },
            "win_rate": {
              "type": "number",
              "description": "Wins as a fraction of total trades (0-1)."
            },
            "gross_pnl": {
              "type": "number",
              "description": "Realized gross profit, funding-excluded."
            },
            "scratches": {
              "type": "integer",
              "description": "Number of scratch (near-breakeven) trades."
            },
            "last_trade": {
              "type": "integer",
              "description": "Unix timestamp of the most recent trade."
            },
            "volume_usd": {
              "type": "number",
              "description": "Total traded notional volume in USD."
            },
            "first_trade": {
              "type": "integer",
              "description": "Unix timestamp of the first trade."
            },
            "profit_factor": {
              "type": "number",
              "description": "Gross winnings over gross losses ratio."
            }
          },
          "description": "Lifetime realized perpetual-futures performance. Present on an active-trading account (observed a 40,593-trade BTC whale) but ABSENT entirely on an account with no trading history (observed an empty flat account) -- do not assume this block is always present.",
          "additionalProperties": false
        },
        "traded_pairs": {
          "type": "integer",
          "description": "Number of distinct markets ever traded."
        },
        "account_value": {
          "type": "number",
          "description": "Total account equity in USD."
        },
        "open_positions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "side": {
                "type": "string",
                "description": "'long' or 'short'; observed 'long'."
              },
              "size": {
                "type": "number",
                "description": "Position size in the base asset."
              },
              "symbol": {
                "type": "string",
                "description": "Perp market symbol, e.g. 'BTC'."
              },
              "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 payments. Observed zero for since_open/since_change on the open position; the field's all-time total was the only nonzero value.",
                "additionalProperties": false
              },
              "entry_price": {
                "type": "number",
                "description": "Average entry price."
              },
              "margin_used": {
                "type": "number",
                "description": "Margin locked in on this position, in USD."
              },
              "max_leverage": {
                "type": "number",
                "description": "Maximum leverage allowed on this market."
              },
              "leverage_type": {
                "type": "string",
                "description": "Margin mode, e.g. 'cross'."
              },
              "leverage_value": {
                "type": "number",
                "description": "Applied leverage multiple."
              },
              "position_value": {
                "type": "number",
                "description": "Current position notional value."
              },
              "unrealized_pnl": {
                "type": "number",
                "description": "Unrealized profit or loss, in USD."
              },
              "return_on_equity": {
                "type": "number",
                "description": "Unrealized PnL as a fraction of equity."
              }
            },
            "additionalProperties": false
          },
          "description": "Currently open perpetual positions. One object per open position on an active account (observed a single open BTC position); an empty array for a flat account."
        },
        "total_unrealized_pnl": {
          "type": "number",
          "description": "Sum of unrealized PnL across all open positions."
        }
      },
      "additionalProperties": false
    },
    "meta": {
      "type": "object",
      "properties": {
        "cached": {
          "type": "boolean",
          "description": "Whether this response was served from a cache; typically false."
        }
      },
      "additionalProperties": false
    },
    "$schema": {
      "type": "null",
      "description": "Always null: the source schema-document pointer is stripped at shaping."
    }
  },
  "description": "The Hyperliquid account-performance record.",
  "additionalProperties": false
}