Cex Trader

Unified CEX trading capability layer for AI agents. Supports OKX and Binance spot and futures trading, account balance queries, order management, position queries, leverage settings, margin mode configuration, market data, and guided API key setup flow. MCP tools: cex-spot-place-order, cex-spot-cancel-order, cex-spot-get-orders, cex-futures-place-order, cex-futures-cancel-order, cex-futures-get-positions, cex-futures-set-leverage, cex-futures-close-position, cex-account-get-balance, cex-account-get-info, cex-market-get-instruments, cex-market-get-kline, cex-market-get-orderbook, cex-market-get-ticker, cex-setup-check, cex-setup-save, cex-setup-verify. Supports action semantics (open_long/open_short/close_long/close_short) and native side+posSide parameters. Built-in idempotency check, rate limiting, and risk controls (margin monitoring, position limits). Supports OKX and Binance exchanges. Swap tokens, buy crypto, sell crypto, CEX trade, exchange order, spot order, futures order, perpetual contract, leverage trading, close position, binance trade, okx trade.

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-http for 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