Portfolio risk report
hl_portfolio_risk[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Risk report for a perp address: liquidation distance per position, effective leverage, concentration (HHI + largest position share), uniform stress scenarios (-5/-10/-20% and mirror), and Sharpe of realized PnL from recent fills. Analytics only, not investment advice.
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_portfolio_risk"
}
}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. | |
| shocks | No | Price-shock fractions to stress test (applied uniformly across positions). | |
| address | Yes | EVM 0x address. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | ||
| positions | Yes | ||
| disclaimer | Yes | ||
| accountValue | Yes | ||
| stressScenarios | Yes | ||
| concentrationHhi | Yes | ||
| effectiveLeverage | Yes | ||
| marginUtilization | Yes | ||
| realizedPnlSharpe | Yes | ||
| largestPositionShare | Yes |