Weex Trading Skill

Intent

execute crypto trades on Weex exchange through the @WEEXonTONbot Telegram bot, with no additional bot fees beyond standard Weex exchange fees. use this skill when you need to check spot prices, view portfolio balances, run dollar-cost averaging (DCA) buy strategies, execute grid trading across price ranges, or manage an active Weex trading account. works for both interactive users and programmatic OpenClaw agents.

Inputs

weex account and API credentials:

• weex account (sign up at https://www.weex.com/en/register?vipCode=gjcr, no KYC required for API trading)
• API key, API secret, and passphrase (generated in weex settings under API Management)
• API key must have "Spot Trading" permission enabled. do not enable withdrawal permissions.

telegram setup:

• access to Telegram and the @WEEXonTONbot bot (https://t.me/WEEXonTONbot)
• for agents: ability to send HTTP requests to the bot's REST API on port 8960 (if running locally), or send Telegram messages via the bot's message endpoint

for grid trading:

• 0.1 TON one-time premium payment to unlock grid trading feature
• minimum $10 USDT investment per grid strategy

external connection:

• weex REST API at https://api-spot.weex.com (Binance-compatible, HMAC-SHA256 signatures, millisecond timestamps)
• rate limits: check Weex API docs for current limits; typical Binance-compatible limits are 1200 requests per minute per account

Procedure

1. set up weex account (once per user or agent):

   • input: weex signup link https://www.weex.com/en/register?vipCode=gjcr
   • navigate to signup and create account (no KYC required for API traders)
   • output: active weex account with email confirmed

2. create and retrieve API credentials:

   • input: logged-in weex account
   • go to Settings > API Management > Create Key
   • enable "Spot Trading" permission only
   • copy the API key, API secret, and passphrase immediately (passphrase is shown once)
   • output: three credential strings ready for storage

3. connect credentials to telegram bot:

   • input: API key, API secret, passphrase from step 2
   • open @WEEXonTONbot in Telegram
   • send message: /connect YOUR_API_KEY YOUR_API_SECRET YOUR_PASSPHRASE
   • the bot deletes your message within seconds for security
   • output: bot confirms "credentials stored and encrypted" (or equivalent success message)

4. check price before trading:

   • input: coin symbol (e.g., BTC, ETH, SOL)
   • send to bot: /price BTC
   • output: current spot price, 24h high/low, 24h volume, percentage change

5. view portfolio balance:

   • input: connected bot credentials
   • send to bot: /balance
   • output: list of all coins held with non-zero balance, quantities, and estimated USD value

6. start DCA (dollar-cost averaging) strategy:

   • input: target coin symbol, USD amount per buy ($1 minimum), time interval (1h, 4h, 12h, 1d, 3d, 7d)
   • send to bot: /dca BTC 100 4h (buys $100 of BTC every 4 hours)
   • output: bot confirms strategy created with strategy ID, next buy timestamp, and total accumulated spend so far

7. start grid trading strategy (premium):

   • input: target coin symbol, low price bound, high price bound, number of grid levels (3-100), total USDT to invest ($10 minimum)
   • ensure 0.1 TON payment is available in account
   • send to bot: /grid ETH 2000 2500 10 500 (creates 10 grid levels between $2000-$2500 with $500 total)
   • output: bot confirms grid strategy created with strategy ID, grid order placement status, and estimated profit range

8. monitor active strategies:

   • input: connected bot credentials
   • send to bot: /status
   • output: list of all active DCA and grid strategies with IDs, current P&L, next action timestamps, and filled order counts

9. stop a running strategy:

   • input: strategy ID from /status output
   • send to bot: /stop dca_a1b2c3d4 or /stop grid_x9y8z7w6
   • output: bot confirms strategy stopped, final P&L summary, and cancels remaining open orders

10. disconnect and remove credentials:

    • input: connected bot credentials
    • send to bot: /disconnect
    • output: bot confirms credentials deleted, all strategies stopped, all open orders canceled

Decision Points

if user has weex API credentials already: skip steps 1-2 and go directly to step 3. if credentials were generated for a different account or have withdrawal permissions enabled, regenerate them with spot-trading-only scope.

if DCA or grid trading fails due to insufficient balance: check /balance output. wait for pending deposits or reduce strategy amount. note that DCA buys only execute if sufficient USDT is available at buy time; if balance is too low, the buy is skipped and retried at the next interval.

if bot response times out or telegram is unreachable: retry the command after 5-10 seconds. if timeouts persist, check that @WEEXonTONbot is running and that your internet connection is stable. for agents using direct API on port 8960, verify the bot process is listening on that port.

if weex API returns 401 (unauthorized) during bot commands: credentials may be expired, revoked, or incorrectly formatted. run /disconnect and /connect again with fresh credentials from weex settings.

if weex API returns 429 (rate limit exceeded): the bot has hit the 1200 request/minute limit on that weex account. wait at least 60 seconds before retrying. if this happens repeatedly, reduce the frequency of /price checks or consolidate multiple strategy updates into single /status calls.

if grid trading premium is not paid (0.1 TON): grid commands return an error message. top up your account with 0.1 TON and retry. DCA strategies (free) will continue to work.

if strategy returns empty result set (e.g., /status shows no strategies): this is normal if no strategies are running. create a new one with /dca or /grid, or check the bot logs if you believe a strategy should exist.

if agent is running on a different host from the bot: direct API calls to port 8960 will fail. use the telegram message interface instead (/price, /balance, /dca, /grid, /status, /stop, /connect, /disconnect).

Output Contract

price check (/price <symbol>):

• format: plaintext or JSON response with fields: symbol, current_price (USD), high_24h, low_24h, volume_24h, change_percent_24h
• example: "BTC: $65,000 (H: $66,500 L: $64,000) Vol: $25B +2.3%"

balance (/balance):

• format: list of coin holdings with fields: symbol, quantity, usd_value
• includes only non-zero balances
• example: "BTC: 0.5 ($32,500) | ETH: 10 ($30,000) | USDT: 5,000 ($5,000)"

DCA strategy create (/dca <symbol> <amount> <interval>):

• format: JSON or plaintext with fields: strategy_id, symbol, amount_per_buy (USD), interval, next_buy_timestamp, status (active)
• example: "DCA created: dca_a1b2c3d4 | BTC $100 every 4h | next buy: 2025-01-15 14:00 UTC"

grid strategy create (/grid <symbol> <low> <high> <levels> <amount>):

• format: JSON or plaintext with fields: strategy_id, symbol, price_range (low-high), num_levels, total_usdt, status (active), estimated_profit_percent
• example: "Grid created: grid_x9y8z7w6 | ETH $2000-$2500 (10 levels) | $500 invested | est profit: +2.5%"

status (/status):

• format: list of active strategies with fields: strategy_id, type (dca or grid), symbol, total_invested (USD), current_pnl (USD), current_pnl_percent, next_action_timestamp, num_filled_orders
• example: "DCA dca_a1b2c3d4 (BTC): invested $800 | P&L: +$50 (+6.25%) | next: 2025-01-15 14:00"

stop strategy (/stop <strategy_id>):

• format: confirmation message with fields: strategy_id, final_pnl (USD), final_pnl_percent, orders_canceled, status (stopped)
• example: "Strategy dca_a1b2c3d4 stopped | final P&L: +$75 (+9.37%) | cancelled 2 pending orders"

connect (/connect <key> <secret> <pass>):

• format: success/error message
• success: "credentials encrypted and stored. ready to trade."
• error: "invalid credentials" or "weex API unreachable"

disconnect (/disconnect):

• format: confirmation message
• "all strategies stopped. credentials deleted. bot reset."

direct API responses (agents):

• GET /api/health: {"status": "ok", "timestamp": "2025-01-15T12:00:00Z"}
• GET /api/price/:symbol: {"symbol": "BTC", "price": 65000, "