get_my_risk_limits_usage
My risk limits and usage · read-only, idempotent ·
scopes: read
The person's global risk limits (per-trade risk, daily / weekly / monthly loss, drawdown, leverage, open positions) and how much of each is used, across all exchanges, plus limit increases waiting to take effect. Use when a trade was rejected by a user-level limit or before planning several trades. Not for this agent's own permissions (use get_my_trading_permissions). No inputs. Fractions of equity and USD; real money and the sandbox are counted separately. Next: size_position_by_risk.
Call it
MCP tools/call
{"name": "get_my_risk_limits_usage", "arguments": {}}
REST
GET /v1/risk
Inputs
| Name | Meaning (* required) |
|---|---|
| none | |
Returns
| Field | Meaning and unit |
|---|---|
pending_loosening | Limit increases a person asked for that are not in force yet |
as_of | ISO 8601 UTC |
book | real or sandbox: the two are counted separately |
equity | Equity in this book, USD |
open_positions | Number of open positions |
trading_halted | True after a stop |
limits | max_risk_per_trade, loss limits and max_drawdown as fractions; max_leverage; max_open_positions; symbols |
realized_pnl | Realised profit or loss for day / week / month (UTC), USD |
drawdown | Drop from peak equity, as a fraction |
Rejections: error codes, each with what to do.