← Back to Skills Marketplace
98
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install cex-trader
Description
Unified CEX trading capability layer for AI agents. Supports OKX and Binance spot and futures trading, account balance queries, order management, position qu...
README (SKILL.md)
cex-trader
v2.0.2 · 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)
MCP Tools (12 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-account-get-balance |
Query account balance |
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-20x) |
cex-futures-close-position |
Close position |
cex-account-get-info |
Get account config and summary |
Changelog
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
Usage Guidance
This skill is internally consistent for remote trading: it needs your OKX/Binance API keys so the MCP server can place orders. Before installing, consider: (1) the default hosted MCP URL (https://mcp-skills.ai.antalpha.com/mcp) will receive your keys — set MCP_SERVER_URL to a self-hosted server if you want to keep keys in your own infrastructure; (2) always create API keys without withdrawal/transfer permissions and enable IP allowlisting on exchange side; (3) you can use demo/sandbox accounts first to test; (4) review the included install.sh and ~/.trader/config.toml to confirm only risk params are written locally; (5) if you don't trust the hosted MCP, do not provide real keys or run your own MCP server. If you want, I can list the exact lines where credentials are sent and where the default MCP URL is referenced.
Capability Analysis
Type: OpenClaw Skill
Name: cex-trader
Version: 2.0.2
The skill is designed to manage and transmit sensitive Centralized Exchange (CEX) API keys and secrets for OKX and Binance to a remote MCP server (defaulting to mcp-skills.ai.antalpha.com). While this behavior is documented in SKILL.md and README.md as part of its 'hosted' service model, the transmission of raw financial credentials to a third-party endpoint constitutes a significant security risk. The implementation in scripts/cex_trader_cli.py and the cex-setup-save tool explicitly facilitates this transfer of secrets over the network.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description (CEX trading for OKX/Binance) match the declared env vars (OKX & Binance API keys) and the provided tools (spot/futures/account/setup). No unrelated credentials or binaries are requested.
Instruction Scope
SKILL.md and the CLI instruct the agent to call MCP tools and to send API credentials to the MCP server (cex-setup-save → mcp / MCP_SERVER_URL). This is consistent with a remote-trading architecture but is materially different from a purely local-only tool: your API keys are transmitted to the MCP endpoint.
Install Mechanism
There is no install spec declared (instruction-only in the registry). The repo includes an install.sh and a CLI script, but nothing will be auto-downloaded from untrusted URLs. install.sh only creates ~/.trader/config.toml (risk params) and makes the CLI executable.
Credentials
Requested env vars (CEX_OKX_*/CEX_BINANCE_* and MCP_SERVER_URL) are proportional to the skill's function. Important: the skill explicitly transmits API keys from environment variables to the MCP server; users should treat this as credential exposure to the configured server and only use keys without withdrawal permissions and with appropriate allowlists.
Persistence & Privilege
always is false and the skill does not request permanent/global privileges or modify other skills. install.sh writes only its own config (~/.trader/config.toml) containing risk parameters, not API keys.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install cex-trader - After installation, invoke the skill by name or use
/cex-trader - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.2
- Fix: Corrected MCP server URL to https://mcp-skills.ai.antalpha.com/mcp in both SKILL.md metadata and the MCP_SERVER_URL environment variable description.
v2.0.1
v2.0.1 introduces improved environment variable documentation and credential handling clarification.
- Declared required environment variables (CEX_OKX_*, CEX_BINANCE_*, MCP_SERVER_URL) in metadata
- Clarified that credentials are only transmitted to the MCP server and not stored on disk
- Updated documentation to align MCP_SERVER_URL default (localhost:3000) and explain hosted usage
v2.0.0
v2.0.0 introduces unified Binance & OKX trading support and major toolset expansion.
- Added full support for Binance spot and futures trading.
- Introduced new onboarding tools: cex-setup-check, cex-setup-save, cex-setup-verify.
- All tools now accept an "exchange" parameter for flexible multi-exchange operations.
- Enhanced error handling and dual-side position management.
- Maintains backward compatibility with default "okx" exchange.
Metadata
Frequently Asked Questions
What is Cex Trader?
Unified CEX trading capability layer for AI agents. Supports OKX and Binance spot and futures trading, account balance queries, order management, position qu... It is an AI Agent Skill for Claude Code / OpenClaw, with 98 downloads so far.
How do I install Cex Trader?
Run "/install cex-trader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Cex Trader free?
Yes, Cex Trader is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Cex Trader support?
Cex Trader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Cex Trader?
It is built and maintained by bevanding (@bevanding); the current version is v2.0.2.
More Skills