cex-trader
v2.0.3 · Unified CEX Trading Capability Layer for AI Agents
⚠️ Risk Warning: Futures trading involves high leverage and may result in significant losses. Only use funds you can afford to lose.
Overview
cex-trader is a unified CEX trading MCP server that enables AI agents to trade on
centralized exchanges (OKX, Binance) through a consistent interface.
Supported Exchanges
- OKX — Spot + Futures (MVP-α, production ready)
- Binance — Spot + Futures (MVP-β, production ready)
Connecting to the MCP Server
This skill talks to the hosted MCP server at https://mcp-skills.ai.antalpha.com/mcp
(transport: streamable-http).
On first use, call antalpha-register once to obtain an agent_id and api_key.
Persist these credentials, then pass agent_id with every subsequent tool call.
MCP Tools (17 total)
Setup Tools
| Tool | Description |
|---|---|
cex-setup-check |
Check if API credentials are configured |
cex-setup-save |
Save API credentials for OKX or Binance |
cex-setup-verify |
Verify credentials via a test API call |
Spot Tools
| Tool | Description |
|---|---|
cex-spot-place-order |
Place spot market or limit order |
cex-spot-cancel-order |
Cancel spot order |
cex-spot-get-orders |
Query spot orders (pending, or filter by state) |
cex-account-get-balance |
Query account balance |
Market Data Tools
| Tool | Description |
|---|---|
cex-market-get-ticker |
Latest ticker (price + 24h stats) for an instrument |
cex-market-get-kline |
K-line/candlestick data (interval, limit up to 300) |
cex-market-get-orderbook |
Order book depth (depth up to 400, default 20) |
cex-market-get-instruments |
List tradable instruments by instType (SPOT/SWAP/FUTURES/OPTION) |
Futures Tools
| Tool | Description |
|---|---|
cex-futures-place-order |
Place futures order (action semantics or native params) |
cex-futures-cancel-order |
Cancel futures order |
cex-futures-get-positions |
Query open positions |
cex-futures-set-leverage |
Set leverage (1-125x) |
cex-futures-close-position |
Close position |
cex-account-get-info |
Get account config and summary |
Changelog
v2.0.3 (2026-06-18)
- Docs: Added market data tools (cex-market-get-ticker, cex-market-get-kline, cex-market-get-orderbook, cex-market-get-instruments) and cex-spot-get-orders to align with the current MCP server (17 tools total)
- Docs: Declared
transport: streamable-httpfor the hosted MCP endpoint - Docs: Added antalpha-register onboarding note (obtain agent_id + api_key on first use)
- Docs: Corrected cex-futures-set-leverage range to 1-125x (was 1-20x)
v2.0.2 (2026-04-14)
- Fix: Corrected MCP server URL from mcp.antalpha.com/cex-trader to mcp-skills.ai.antalpha.com/mcp in mcp.url and MCP_SERVER_URL description
v2.0.1 (2026-04-14)
- Docs: Declared required env vars (CEX_OKX_, CEX_BINANCE_, MCP_SERVER_URL) in SKILL.md metadata
- Docs: Clarified credential transmission path (env vars → MCP server; ~/.trader/config.toml stores risk params only)
- Docs: Aligned MCP_SERVER_URL default (localhost:3000) with hosted URL in SKILL.md
v2.0.0 (2026-04-13)
- Added: Full Binance exchange support (Spot + Futures, MVP-β)
- Added: ExchangeRouter, BinanceClientService (HMAC-SHA256 signing)
- Added: cex-setup-check / cex-setup-save / cex-setup-verify onboarding tools
- Fixed: BINANCE_ERROR_MAP error code mappings
- Fixed: closePosition dual-side mode handling
- All original tools now accept exchange parameter (defaults to okx, backward-compatible)
v1.0.0 (2026-04-10)
- Initial release: OKX spot + futures trading (MVP-α)
- 9 MCP tools, action semantics, idempotency, risk controls
