Get account positions & margin
hl_get_accountPerp account snapshot for any address: equity, margin usage, withdrawable, and open positions (size, entry, uPnL, leverage, liquidation price). Read-only; works for any public 0x address.
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": "hl_get_account"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dex | No | Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex. | |
| address | Yes | EVM 0x address (42 hex chars). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | ||
| positions | Yes | ||
| totalNtlPos | Yes | ||
| accountValue | Yes | ||
| withdrawable | Yes | ||
| totalMarginUsed | Yes | ||
| marginUtilization | Yes |