Open perp positions for an address (snapshot)
flowscan_address_perp_positionsLook up an account's open perpetual positions across all markets, including HIP-3, with size, notional, leverage, liquidation, and PnL from the latest snapshot.
Instructions
Homepage perp snapshot address lookup: an account's open perp positions across all markets incl. HIP-3 (market, side, signed size, notional, entry, leverage, liquidation price, funding PnL, all-time PnL) from the latest snapshot (refreshes every few minutes), with totalNotional and totalPositions. Sorted by notional desc. For live margin/account state use flowscan_address_summary.
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": {
"address": "<address>"
},
"name": "flowscan_address_perp_positions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| side | No | Only long or only short positions. | |
| limit | No | Max list items (default per tool). | |
| fields | No | Paths to keep, relative to `data` (list tools: each row); misses go to _fieldsNotFound. | |
| market | No | Filter by market symbol substring (e.g. 'BTC', 'xyz:'). | |
| offset | No | List items to skip. | |
| address | Yes | Account address (0x + 40 hex). |