get_positions_by_address
Retrieve open perpetual futures positions for any account by public address across supported DEX venues; read-only, no private key required.
Instructions
Open positions of ANY account by its public address — keyless, read-only (public venue data; nothing is signed, no key is needed). Venues: pacifica (base58 Solana address), hyperliquid (0x address), lighter (0x address), lighter-rh (0x address), risex (0x address). Hyperliquid reads the native dex and every HIP-3 dex (rows carry dex: null | ""; a dex that fails is listed in meta.errors / meta.warnings — its rows are missing, not absent); Lighter reads every account of the address (rows carry accountIndex; accountIndex narrows). Other venues: CAPABILITY_UNSUPPORTED; a wrong address format: INVALID_PARAMS. Same rows as perp -e <venue> account positions --address <addr>.
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": {
"exchange": "<exchange>",
"address": "<address>"
},
"name": "get_positions_by_address"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | No | Only this market (plain asset, e.g. BTC) | |
| address | Yes | Public account address (0x… for hyperliquid / lighter / lighter-rh; base58 Solana for pacifica) | |
| exchange | Yes | Exchange: pacifica, hyperliquid, lighter, lighter-rh, risex (aliases accepted) | |
| accountIndex | No | Lighter only: one account (sub-account) of the address |