WEEX API#

Use:

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

For private endpoints:

bash

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#

bash

# 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:

bash

# 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:

bash

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