MUTEX
Get started
Developers

Docs

Three developer surfaces. The two REST APIs share one base URL (https://trade.mutex.trade) and one auth scheme. Every endpoint shape is in the live OpenAPI spec - the pages below are the narrative, the reference is the truth.

Open interactive reference live OpenAPI spec · always in sync with the deployed API
Trading APIREST · keyDrive one isolated API bot account: place, modify and cancel orders, read positions, fills and market data.Quickstart
Affiliate APIREST · read-onlyYour referrals, window totals and per-day commission split by avenue. Everything the dashboard shows, in JSON.Quickstart
MCP serverAI agentsHand an AI agent a bot sub-account, or your whole account with an agent key. Local MCP server, two modes, with the system prompt that makes it trade well.Set it up
Shared

One key, one scope

Every authed route takes Authorization: Bearer <key>. These docs cover three kinds, all issued display-once in the web app:

  • mtx_bot_… - a trading key, bound to one API bot account or to one vault.
  • mtx_aff_… - an affiliate key, read-only over your own referral stats.
  • mtx_agent_… - your agent key. On this API it reaches Predictions (/v1/prediction/*) and posts, nothing else.

A trading key on an affiliate route is 403 wrong_key_kind, and so is any key on a route meant for another kind. Public market data (/v1/markets, /v1/candles) needs no key at all:

curl https://trade.mutex.trade/v1/markets
Shared

Wire conventions

  • Numbers are decimal strings on output ("0.5"); inputs accept strings or JSON numbers.
  • Timestamps are Unix milliseconds, except affiliate day buckets, which are YYYY-MM-DD UTC days.
  • Errors are an honest HTTP status plus { "error": { "code", "message" } }. Match on code, never on prose.
  • Lists paginate by cursor: pass a response's next_before back as ?before= until it returns null.
Shared

What moves money

Neither the trading key nor the affiliate key can deposit, withdraw, swap or transfer, and neither can touch your main perp account. Funding, payouts and settings stay in the web app on purpose - the blast radius of a leaked key is one bot's balance, or read-only referral stats.

On this API, the agent key moves money only between your Funding balance and Predictions, and Prediction money only ever comes back to Funding. What else it can do as you is on the Agent access page.