> For the complete documentation index, see [llms.txt](https://hyperliquid-ohlc.gitbook.io/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hyperliquid-ohlc.gitbook.io/api-docs/rest-api/wallet/account-value-history.md).

# Account Value History

## Get wallet account value history

> Retrieve account value snapshots for a wallet address over a time range. Returns perp, main, and spot account values in descending order.

```json
{"openapi":"3.1.0","info":{"title":"BlockLiquidity API Service","version":"1.0.0"},"servers":[{"url":"https://data.blockliquidity.xyz"}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"WalletAccountValueResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/WalletAccountValue"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"WalletAccountValueResponse"},"WalletAccountValue":{"properties":{"timestamp":{"type":"integer","title":"Timestamp"},"perp_account_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Perp Account Value"},"perp_account_pnl":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Perp Account Pnl"},"perp_account_vlm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Perp Account Vlm"},"main_account_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Main Account Value"},"main_account_pnl":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Main Account Pnl"},"main_account_vlm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Main Account Vlm"},"spot_account_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Spot Account Value"},"vault_equities":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vault Equities"},"delegated_account_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delegated Account Value"},"undelegated_account_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Undelegated Account Value"}},"type":"object","required":["timestamp","perp_account_value","perp_account_pnl","perp_account_vlm","main_account_value","main_account_pnl","main_account_vlm","spot_account_value","vault_equities","delegated_account_value","undelegated_account_value"],"title":"WalletAccountValue"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v1/wallets/{address}":{"get":{"tags":["Wallet Data"],"summary":"Get wallet account value history","description":"Retrieve account value snapshots for a wallet address over a time range. Returns perp, main, and spot account values in descending order.","operationId":"get_wallet_account_value_v1_wallets__address__get","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","title":"Address"}},{"name":"start_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Start timestamp in Unix milliseconds","title":"Start Timestamp"},"description":"Start timestamp in Unix milliseconds"},{"name":"end_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"End timestamp in Unix milliseconds","title":"End Timestamp"},"description":"End timestamp in Unix milliseconds"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of records to return","default":30,"title":"Limit"},"description":"Number of records to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletAccountValueResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```