> 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/volume-by-time-range.md).

# Volume by Time Range

## Get wallet volume

> Retrieve total trading volume for a wallet address over a time period. Optionally filter by specific token.

```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":{"VolumeResponse":{"properties":{"start_date":{"type":"integer","title":"Start Date"},"end_date":{"type":"integer","title":"End Date"},"total_volume":{"type":"number","title":"Total Volume"},"total_trades":{"type":"integer","title":"Total Trades"},"closed_trades":{"type":"integer","title":"Closed Trades"},"unique_tokens_traded":{"type":"integer","title":"Unique Tokens Traded"},"avg_daily_volume":{"type":"number","title":"Avg Daily Volume"},"token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}},"type":"object","required":["start_date","end_date","total_volume","total_trades","closed_trades","unique_tokens_traded","avg_daily_volume"],"title":"VolumeResponse"},"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}/volume":{"get":{"tags":["Wallet Data"],"summary":"Get wallet volume","description":"Retrieve total trading volume for a wallet address over a time period. Optionally filter by specific token.","operationId":"get_wallet_volume_v1_wallets__address__volume_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":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by specific token (e.g., BTC, ETH, @151)","title":"Token"},"description":"Filter by specific token (e.g., BTC, ETH, @151)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VolumeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```