Weex

MCP Tools

Automated trading tool for WEEX API, supporting futures and spot trading, including natural language order placement, order cancellation, order query, market data and account data retrieval.

Install

openclaw skills install weex

WEEX API

Use:

scripts/weex_contract_api.py for contract
scripts/weex_spot_api.py for spot

For private endpoints:

export WEEX_API_KEY="..."
export WEEX_API_SECRET="..."
export WEEX_API_PASSPHRASE="..."
export WEEX_API_BASE="https://api-contract.weex.com"
export WEEX_LOCALE="en-US"

Fast Path

# Contract
python3 scripts/weex_contract_api.py list-endpoints --pretty
python3 scripts/weex_contract_api.py ticker --symbol BTCUSDT --pretty
python3 scripts/weex_contract_api.py poll-ticker --symbol BTCUSDT --interval 2 --count 30 --pretty

# Spot
python3 scripts/weex_spot_api.py list-endpoints --pretty
python3 scripts/weex_spot_api.py ticker --symbol BTCUSDT --pretty

Natural Language Order

Natural language is interpreted by the agent layer.
Scripts no longer parse keywords from free text.

The agent must convert user intent into structured fields, then call deterministic commands:

# Contract V3
python3 scripts/weex_contract_api.py place-order \
  --symbol ETHUSDT --side SELL --position-side SHORT --type LIMIT \
  --quantity 0.001 --price 10000 --time-in-force GTC --confirm-live --pretty

# Spot V3
python3 scripts/weex_spot_api.py place-order \
  --symbol ETHUSDT --side BUY --order-type LIMIT \
  --quantity 0.001 --price 999 --time-in-force GTC --confirm-live --pretty

Safety Policy

Never send mutating requests without --confirm-live.
Default flow is direct live execution (no dry-run step).
If instruction is ambiguous or missing fields, ask only for missing fields.

Regenerating API Definitions

Local contract and spot definitions are generated from the live WEEX V3 docs:

python3 scripts/generate_weex_api_definitions.py --product all

References

references/spot-endpoints.md
references/spot-api-definitions.json (machine-readable local spot interface definitions)
references/spot-api-definitions.md (human-readable local spot interface definitions)
references/contract-api-definitions.json (machine-readable local interface definitions)
references/contract-api-definitions.md (human-readable local interface definitions)
references/contract-endpoints.md
references/auth-and-signing.md
references/websocket.md