WEEX Futures Trading Skill 🔵

An Open AI Agent Skill for trading USDT-margined perpetual futures on WEEX exchange with up to 125x leverage.

Universal Compatibility: This skill works with any AI agent that supports bash/curl commands, including Claude, GPT-4, Gemini, LLaMA, Mistral, and other LLM-based coding assistants.

Features

• Market Data - Real-time ticker, order book, trades, candlesticks, funding rates
• Account Management - Check balances, positions, leverage settings
• Order Operations - Place market/limit orders, cancel orders, close positions
• Position Management - Open long/short, close positions, adjust margin
• Trigger Orders - Stop-loss, take-profit, and conditional orders
• TP/SL Orders - Position-level take-profit and stop-loss
• AI Integration - Log AI trading decisions to WEEX
• Python CLI Client - Command-line tool for quick API interactions

Supported AI Agents

Installation

As AI Agent Skill

The skill can be loaded by any AI agent that reads markdown-based skill definitions:

# Clone the repository
git clone https://github.com/bowen31337/weex-futures-trading-skill.git

# Or download just the skill file
curl -L -o SKILL.md \
  https://raw.githubusercontent.com/bowen31337/weex-futures-trading-skill/main/weex-trading/SKILL.md

For Claude Code

# Install to Claude Code skills directory
cp SKILL.md ~/.claude/skills/weex-trading.md

For Other AI Agents

Most AI agents can use this skill by:

1. Loading the SKILL.md file into the conversation context
2. Or referencing it as a system prompt
3. Or using your agent's skill/plugin installation mechanism

As Standalone Python Client

git clone https://github.com/bowen31337/weex-futures-trading-skill.git
cd weex-futures-trading-skill
pip install requests

Configuration

Set your WEEX API credentials as environment variables:

export WEEX_API_KEY=your_api_key
export WEEX_API_SECRET=your_api_secret
export WEEX_PASSPHRASE=your_passphrase
export WEEX_BASE_URL=https://api-contract.weex.com  # Optional

Getting API Keys

1. Log in to your WEEX account at weex.com
2. Navigate to API Management in account settings
3. Create a new API key with required permissions:
   • Read - View account info, positions, order history
   • Trade - Place and cancel orders
4. Save your API Key, API Secret, and Passphrase securely

Usage

Python CLI Client

# Market Data (no authentication required)
python scripts/weex_client.py time                    # Server time
python scripts/weex_client.py ticker cmt_btcusdt      # Get BTC price
python scripts/weex_client.py depth cmt_btcusdt       # Order book
python scripts/weex_client.py funding cmt_btcusdt     # Funding rate

# Account Info (authentication required)
python scripts/weex_client.py assets                  # Account balances
python scripts/weex_client.py positions               # All positions
python scripts/weex_client.py orders                  # Open orders
python scripts/weex_client.py settings                # Leverage settings

# Trading
python scripts/weex_client.py buy cmt_btcusdt 10              # Market buy 10 contracts
python scripts/weex_client.py buy cmt_btcusdt 10 95000        # Limit buy at $95,000
python scripts/weex_client.py sell cmt_btcusdt 10             # Market short 10 contracts
python scripts/weex_client.py close_long cmt_btcusdt 10       # Close long position
python scripts/weex_client.py close_short cmt_btcusdt 10      # Close short position

# Order Management
python scripts/weex_client.py cancel 1234567890       # Cancel order by ID
python scripts/weex_client.py cancel_all              # Cancel all orders
python scripts/weex_client.py close_all               # Close all positions

# Account Settings
python scripts/weex_client.py leverage cmt_btcusdt 20 # Set 20x leverage

With AI Agents

Once loaded as a skill, any compatible AI agent can help you trade on WEEX:

You: What's the current BTC price on WEEX?
Agent: [Fetches ticker data and displays price]

You: Open a long position on BTC with 10 contracts
Agent: [Confirms order details and executes after your approval]

You: Show my current positions
Agent: [Displays all open positions with PnL]

You: Set a stop-loss at $90,000 for my BTC position
Agent: [Creates trigger order for risk management]

The skill provides curl commands that any AI agent with shell access can execute.

API Reference

Order Types

Execution Types

Margin Modes

Popular Trading Pairs

Rate Limits

Error Codes

Safety Notes

• Always verify order details before confirming trades
• Check balance before placing orders
• Understand leverage risks - higher leverage = higher risk
• Use stop-loss orders to manage risk
• Start with small positions when testing

Project Structure

weex-trading/
├── SKILL.md                 # Open AI Agent skill definition (37 API endpoints)
├── README.md                # This file
├── scripts/
│   └── weex_client.py       # Python CLI client
└── references/
    └── api_reference.md     # API endpoint quick reference

Skill Coverage

The SKILL.md provides complete coverage of the WEEX Futures API:

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/new-feature)
3. Commit changes (git commit -m 'Add new feature')
4. Push to branch (git push origin feature/new-feature)
5. Open a Pull Request

License

MIT License - see LICENSE for details.

What is an Open Agent Skill?

An Open Agent Skill is a markdown-based skill definition that can be used by any AI agent with code execution capabilities. Unlike proprietary plugin formats, open agent skills:

• 📖 Human-readable - Written in Markdown with embedded code blocks
• 🔌 Universal - Work with any AI agent (Claude, GPT, Gemini, LLaMA, etc.)
• 🛠️ Self-contained - Include all necessary code snippets and documentation
• 🔒 Transparent - Users can inspect exactly what commands will be executed
• 🤝 Shareable - Easy to distribute, fork, and contribute to

Links

• WEEX Exchange
• WEEX API Documentation
• Releases
• Open Agent Skills Community