Who holds a perp market
reservoir_positionsRetrieve every open position in a perp market from a daily snapshot to compare long vs short accounts, notional, average entry, leverage, largest positions, liquidation prices, liquidation clusters.
Instructions
Every open position in a perp market from the daily snapshot: long vs short accounts and notional, average entry, leverage, largest positions with liquidation prices, and where liquidations cluster.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"market": "<market>"
},
"name": "reservoir_positions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | How many of the largest positions to list. | |
| date | No | Snapshot day (UTC date). Default: newest snapshot. | |
| market | Yes | 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||