get_my_trading_permissions
My trading permissions · read-only, idempotent ·
scopes: read
What this agent may do right now on TradeHub: autonomy level (read, propose = every order needs a person's approval, preauth = executes within limits), allowed venues, symbols and actions, per-trade and daily limits, today's usage, connected venues and whether trading is halted. Use first in every session and after any rejection that mentions your mandate. Not for account balances (use get_my_account_balances). No inputs. Limits are fractions of equity or USD. Only a person can widen them, on the Web, and widening waits 24 hours. Next: size_position_by_risk or get_my_open_positions.
Call it
MCP tools/call
{"name": "get_my_trading_permissions", "arguments": {}}
REST
GET /v1/me/mandate
Inputs
| Name | Meaning (* required) |
|---|---|
| none | |
Returns
| Field | Meaning and unit |
|---|---|
mandate | This agent's trading permissions (its mandate): level (read / propose / preauth), venues, symbols, actions, max_risk_pct (fraction of equity at stop), max_leverage, max_notional_usd, max_positions, daily_loss_budget_usd, daily_order_limit, expires_at. null on a limit = only the user's global limit |
scopes | OAuth / API key scopes this caller holds |
today | orders_today and realized_pnl_today (USD) for this agent, UTC day |
venues_connected | Venues the user has connected (sandbox is always there) |
trading_halted | True after a stop: no new positions until a person resumes on the Web |
delegation | Who this agent acts for and where its rights come from |
Rejections: error codes, each with what to do.