weex-trader-skill

name	weex-trader-skill
description	Use when the user wants WEEX API automation via REST for both contract and spot, including order execution from natural language, cancel/query, and market/account data retrieval.
metadata	{"version":"1.6.0"}

WEEX Trader Skill

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.

Updates

Publish updates as GitHub Releases with asset weex-trader-skill.skill.

Users can check/apply updates:

python3 scripts/skill_update.py check --repo <owner>/<repo>
python3 scripts/skill_update.py update --repo <owner>/<repo>

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
• references/updates.md