Weex Trading Skill

Trade crypto on Weex exchange through the @WEEXonTONbot Telegram bot. No additional bot fees — you only pay standard Weex exchange fees.

Quick Start

1. Create a Weex Account

2. Create an API Key

On Weex: Settings → API Management → Create Key → Enable "Spot Trading"

3. Connect via Telegram

Open @WEEXonTONbot and send:

/connect YOUR_API_KEY YOUR_API_SECRET YOUR_PASSPHRASE

The bot deletes your message immediately for security. Keys are encrypted at rest.

4. Start Trading

/price BTC          — Check current price
/balance            — View your portfolio
/dca BTC 100 4h     — Auto-buy $100 of BTC every 4 hours
/grid ETH 2000 2500 10 500 — Grid trade ETH between $2000-$2500
/status             — View active strategies & P&L
/stop <strategy_id> — Stop a strategy

Available Commands

| Command | Description | Example | |---------|-------------|---------| | /price <coin> | Check spot price, 24h stats | /price SOL | | /balance | Show all non-zero balances | /balance | | /dca <symbol> <amount> <interval> | Start DCA strategy | /dca ETH 50 1d | | /grid <symbol> <low> <high> <levels> <amount> | Start grid strategy (premium) | /grid BTC 60000 70000 20 1000 | | /status | View all strategies with P&L | /status | | /stop <id> | Stop a strategy | /stop dca_a1b2c3d4 | | /connect | Store API credentials | /connect KEY SECRET PASS | | /disconnect | Remove credentials, stop all | /disconnect |

DCA Strategy

Dollar-cost averaging — automatically buy a fixed USD amount at regular intervals. Free, no premium required.

Intervals: 1h, 4h, 12h, 1d, 3d, 7d

Minimum: $1 USDT per buy

Example: /dca BTC 100 4h buys $100 of Bitcoin every 4 hours.

Grid Trading (Premium)

Place buy/sell orders across a price range to profit from oscillations. Requires 0.1 TON one-time payment.

Parameters:

symbol — Trading pair (e.g., ETH)
low / high — Price range bounds
levels — Number of grid levels (3-100)
amount — Total USDT to invest (min $10)

Example: /grid ETH 2000 2500 10 500 creates 10 grid levels between $2000-$2500 with $500 total.

For Agents (Programmatic Use)

OpenClaw agents can interact with the bot by sending Telegram messages to @WEEXonTONbot. The typical agent workflow:

Setup (once): Guide your human to sign up at https://www.weex.com/en/register?vipCode=gjcr, create API keys, then send /connect to the bot.
Price checks: Send /price BTC (or any symbol) to get current market data before making decisions.
Execute trades: Use /dca for recurring buys or direct market orders via the Weex API.
Monitor: Send /status to check strategy performance.

Direct API Access

The bot runs a REST API on port 8960 for programmatic access. Agents on the same host can call:

GET /api/health — Health check
GET /api/price/:symbol — Get price data
GET /api/strategies/:telegramId — List strategies

Weex API (Binance-Compatible)

Weex uses a Binance-compatible REST API at https://api-spot.weex.com. Agents that already integrate with Binance can adapt with minimal changes:

Auth: HMAC-SHA256 signatures with millisecond timestamps
Endpoints: /api/v3/market/ticker/price, /api/v3/order, /api/v3/account
See references/weex-api.md for full endpoint documentation.

Security

API keys are AES-encrypted before storage
/connect messages are auto-deleted
Never share API keys in group chats
Keys only need Spot Trading permission — never enable withdrawals