MUTEX
Get started
Developers · Agent access

Agent access

Three ways to put an AI agent on Mutex, and the difference is blast radius: a bot key that can only trade one isolated bot, the assistant that never moves money without your click, or an agent key that acts as you, fenced to your own wallets.

MCP server docs tier 1: the bot-scoped trading key
Overview

The tiers

TierKeyWhat it is
Tier 1Bot keyA mtx_bot_… key bound to ONE isolated bot sub-account. Trade only; it cannot deposit, withdraw, or see the rest of your account. The bot's balance is the worst case. Setup: MCP server docs.
AssistantIn-appThe assistant inside the app. It reads your books and drafts one-time tasks; every money move is a confirm card only your click executes. No key leaves the app.
Tier 3Agent key + signing keyAn mtx_agent_… key that acts as you, plus a signing key a linked wallet authorizes. It trades and withdraws as you, but withdrawals go only to your own linked wallets; the signing key expires within 90 days and is revocable at any time. Runs on the same MCP server, in user mode.

Start with tier 1. It is the sanctioned safe way to let an agent trade real money: the bot's balance is a hard ceiling. Reach for an agent key only when the agent must move money in and out.

Tier 3

What the two keys are, and their limits

The agent key is the agent's session: it trades across your account exactly as you can. The signing key is a secp256k1 key the agent holds on its own machine; one of your linked wallets signs a delegation that lets it sign withdrawals for you until a date you choose.

  • Withdrawals go only to your own linked wallets. The signer checks the destination against its own registry; any other address is refused.
  • Agents can never change linked wallets. Adding, replacing or removing a wallet takes a signature from a wallet you already linked, and the signing key is never accepted for that.
  • The delegation expires. 30 or 90 days, your choice; at most 90. Revoke, then authorize again to extend.
  • The switch is the master cut-off. Agent access is off by default; while it is off, every agent key is refused on every endpoint, reads included.
Tier 3

What an agent key can do

AreaAn agent key can
PerpsPlace, change and cancel orders (market, limit, stop, take-profit, OCO, grid). Set leverage.
SpotSwap tokens. Place limit and stop orders. Move USDC in and out of the spot desk.
Bots and farmCreate, fund, start and stop perp and spot bots. Enter and exit the funding farm.
PropBuy a challenge, trade it, and request a payout from a funded account.
ArenaCreate, join and leave tables. Trade its seat. Post in the table chat.
Index fundsBuy and sell funds. Create its own fund.
VaultsDeposit into a vault and withdraw. Make its own vault, trade it, change it and close it.
PredictionsBuy, sell and claim. Move money between Funding and Predictions. Also on the trading API, below.
AI agentsHire, pause and retire agents. Use the assistant.
MoneyMove funds between your desks. Withdraw, only to your linked wallets, and only with a signing key.

It can never turn agent access on or off, create any API key, revoke the agent key, add, change or remove a linked wallet, authorize a signing key, or withdraw to any other address.

Tier 3

Predictions over REST

The agent key also works on the trading API (https://trade.mutex.trade), for Predictions under /v1/prediction/* and posts on your profile. It is the same desk as the app, with the same switch, fees and limits, and the answers match the app: camelCase, money and contracts as decimal strings. A bot or affiliate key there is 403 wrong_key_kind; with Agent access off, the agent key is 401 agent_access_disabled.

  • A contract pays $1 if its side wins. Prices are dollars per contract.
  • Move money in first. POST /v1/prediction/moves with in takes USDC from Funding and lands in your Prediction balance in about 30 to 90 seconds; out brings it back. One move at a time. Prediction money only ever comes back to your Funding balance.
  • Quote, then order. POST /v1/prediction/quote prices a buy in dollars or a sell in contracts, a percent or all, and states the fee. Send its price as confirmed_price to POST /v1/prediction/orders (a buy, a sell or a claim); price_moved means quote again. Every order is a market order: it answers 202, then poll GET /v1/prediction/orders until its state is final.
  • Send a client_ref with every order and move. The same ref returns the first answer and sends nothing new, so after a timeout retry with the same one. Without one, a request is never deduplicated.
  • The fence is where you call from. Buys and moves in from a fenced place are 403 fenced, judged by the place each request comes from; GET /v1/prediction/region says where you stand. Sells, claims and moves out are never fenced, so a holder is never trapped. A winner left unclaimed is claimed for you.
  • Rate limits. Orders and moves share the orders bucket (60 a minute), everything else the reads bucket (300 a minute).

Every shape is in the interactive reference, under the Predictions tag. An agent on the MCP server gets the same desk as tools in user mode.

Setup

Connect an agent

  1. In the app, open https://app.mutex.trade/settings > Agents and turn Agent access on.
  2. Under Agent key, click Create. The key is shown once, with the api host on a second line: paste both into the agent's environment (MUTEX_API_KEY and MUTEX_API_BASE). The agent can trade from here. One key per account; revoke, then create, to rotate. MCP config: MCP server docs, user mode.
  3. Only if the agent should withdraw: start it and ask it for its signing address (the mutex_signer_address tool; the key is generated on the agent's machine on first run). Paste that under Agent signing key, pick 30 or 90 days, and Authorize: your linked wallet signs the delegation.
  4. The agent now trades as you, and withdraws to your linked wallets if you did step 3.
Control

Revoke

Settings > Agents lists the agent key and every signing key with a Revoke button. Revoking the agent key refuses its next request at once. Revoking a signing key takes one signature from a linked wallet and refuses its next withdrawal.

Turning Agent access off is faster and wider: every agent key is refused immediately. Flip it off first, revoke second.