Trade
Read an account and submit orders through the rwa.wtf MCP.
Trade is the higher-permission MCP scope. A Trade key includes every Intel route, then adds 6 tools for account data and order management, 37 tools total. It uses the same MCP endpoint and the same market-data routes as an Intel key.
The additional Trade routes can submit orders with real funds on the connected account. Use an Intel key when an agent only needs research data.
Connect · View Intel routes · View Trade routes
Trade routes
Account data
| Tool | Returns |
|---|---|
get_account_snapshot | Collateral, available balance, committed margin, margin requirements, positions, leverage, liquidation prices, assets, and order counts |
get_account_activity | Active orders, inactive orders, fills, and funding history |
Call get_account_snapshot before sizing or closing an order. get_account_activity does not return current balances or positions.
Orders
| Tool | Required input | Result |
|---|---|---|
place_order | marketId, side, kind, quantity, leverage | Places 1 order |
cancel_order | marketId, clientOrderIndex | Cancels 1 resting order |
cancel_all_orders | marketId | Cancels every resting order in 1 market |
modify_order | marketId, clientOrderIndex, quantity, price | Reprices or resizes 1 resting order |
quantity, price, and triggerPrice are decimal strings. Call get_markets for current market IDs, quantity precision, price precision, and leverage limits.
Place order fields
| Field | Values |
|---|---|
side | buy, sell |
kind | market, limit, stop-loss, stop-loss-limit, take-profit, take-profit-limit, twap |
leverage | 1 to 100, subject to the market limit |
reduceOnly | Prevents the order from increasing exposure |
postOnly | Valid for resting orders, not market orders |
expiryMs | 0 for good till canceled |
slippageBps | 1 to 500, default 5 |
idempotencyKey | Reuse the same value when retrying the same order |
price is required for limit and TWAP orders. triggerPrice is required for stop and take-profit orders.
Recommended sequence
- Call
get_marketsand identify the market ID. - Call
get_account_snapshotand check available collateral, current exposure, margin, and leverage. - Submit the order with an explicit quantity and idempotency key.
- Call
get_account_activityto confirm its status and obtainclient_order_index. - Modify or cancel a resting order with
clientOrderIndex. - Call
get_account_snapshotagain to verify the final position and margin state.
Order handling
- The venue generally rejects orders below $10. Market-specific quantity minimums also apply.
place_ordercreates 1 order. It does not attach a stop-loss or take-profit bracket.- To protect an open position, submit a separate reduce-only
stop-lossortake-profitorder after the entry fills. - Use
client_order_indexfromget_account_activityfor cancel and modify calls. Do not useorder_index, it can exceed the range represented safely by JSON numbers. cancel_all_ordersremoves resting orders in 1 market. It does not close a position.- A market order can fill before a response is received. Do not retry it with a new idempotency key.
Permissions
Trade keys can read their own venue account and submit, modify, or cancel orders. They cannot:
- Deposit funds
- Withdraw funds
- Add a withdrawal address
- Start a venue migration
- Read the browser session
- Create or revoke API keys
Funding, withdrawals, migration, and key management require an authenticated browser session. No MCP tool can move funds off the venue.
Limits and revocation
Trade keys share the account limits documented on the Intel page. Account and order calls also count toward the broader 60-request rolling-minute limit.
Revoking a key stops new requests immediately. It does not cancel resting orders or close positions. Review the account in the terminal before revoking a key that has traded.
rwa.wtfdocs