Portfolio History

Hyperliquid

Returns historical account value and profit or loss for one user.

Endpoint

POST /portfolio

Request

{
  "user": "0x1234567890abcdef1234567890abcdef12345678",
  "period": "perpWeek"
}

Field	Type	Required	Description
`user`	string	Yes	User wallet address
`period`	string	No	`perpDay`, `perpWeek`, `perpMonth`, or `perpAllTime`

The default period is perpWeek. An unrecognized period also falls back to that default. This dedicated endpoint depends on a healthy read replica and can return 503 while the replica is unavailable, syncing, or behind. Honor Retry-After when provided. Do not send type: "portfolio" to /info.

Response

200: Complete
200: Degraded

{
  "accountValueHistory": [[1702512000000, "10000.00"]],
  "pnlHistory": [[1702512000000, "0.00"]],
  "vlm": "0",
  "status": "ok",
  "warnings": []
}

{
  "accountValueHistory": [],
  "pnlHistory": [],
  "vlm": "0",
  "status": "degraded",
  "warnings": [
    {
      "asset": "BTC",
      "assetId": "00020000",
      "timestamp": 1702512000000,
      "type": "perp",
      "reason": "Historical price unavailable",
      "impact": "valuation"
    }
  ]
}

Field	Type	Description
`accountValueHistory`	array	`[timestamp, value]` points
`pnlHistory`	array	`[timestamp, profitOrLoss]` points
`vlm`	string	Reserved; currently `"0"`
`status`	`"ok"` \| `"degraded"`	`degraded` means one or more price lookups were missing
`warnings`	array	Details about missing prices used to calculate history

Each timestamp is a Unix-millisecond number. Each value is a decimal string.

Warning Fields

Field	Type	Description
`asset`	string	Asset symbol
`assetId`	string	AssetId
`timestamp`	number	Time for which price data was missing
`type`	string	`spot` or `perp`
`reason`	string	Explanation
`impact`	string	Optional: `valuation`, or `cashflow_basis` when a missing price affects the starting value used for profit or loss

If price history is temporarily unavailable, the response can contain empty histories.

Venue Coverage

The current history calculator does not replay finalized Polymarket fills, split/merge operations, or redemption accounting. Do not use this response as a complete Polymarket performance history. Read Fill History and Positions for those trading records.

Start Here

Info

Analytics

Exchange

WebSocket

Endpoint

Request

Response

Warning Fields

Venue Coverage

​Endpoint

​Request

​Response

​Warning Fields

​Venue Coverage

Endpoint

Request

Response

Warning Fields

Venue Coverage