Fills, volume and liquidations
reservoir_fillsQuery historical Hyperliquid fills and trade metrics for a market, venue, or wallet over any date range, including volume, flow, liquidations, VWAP, and optional raw fills.
Instructions
Trades for a market, a venue or a wallet over any past window: taker volume, buy/sell split, net flow, long/short liquidations, VWAP, high/low, wallets, plus optional breakdowns and raw fills.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "reservoir_fills"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | UTC. A date ("2026-10-26"), date-time ("2026-10-26T14:00:00Z"), relative ("7d", "24h") or Unix ms. A date-only end includes that whole day. Default: the newest day in Reservoir. | |
| kind | No | Which fill file to read. liquidations/adl/twap_fills/builder_fills are much smaller than all. | all |
| rows | No | Also return this many individual fills (0 = none). | |
| start | No | UTC. A date ("2026-10-26"), date-time ("2026-10-26T14:00:00Z"), relative ("7d", "24h") or Unix ms. A date-only end includes that whole day. Default: the newest day in Reservoir. | |
| venue | No | Venue when no market is given (default hyperliquid). | |
| market | No | Market as Reservoir names it: "BTC" (Hyperliquid perp), "xyz:MSFT" (HIP-3 perp), "@107" or "PURR/USDC" (spot), "#114940" (HIP-4). Case is fixed automatically for perps. Omit to cover a whole venue. | |
| address | No | Only this wallet (0x...). Reservoir files are per day, so this scans whole days. | |
| min_usd | No | With rows: only fills of at least this USD value, largest first. | |
| group_by | No | Also return a breakdown. | none |
| with_tx_hash | No | Include tx_hash in rows (the largest column; costs more). | |
| max_download_mb | No | Stop if the estimated download is larger than this many MB (default 1024). Raise it only if the user accepts the AWS cost. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||