weex-trading

# WEEX Futures Trading 🔵

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

> **Open Agent Skill**: This skill is designed to work with any AI agent that supports bash/curl commands, including Claude, GPT, Gemini, LLaMA, Mistral, and other LLM-based agents.

## Features

- 📊 **Futures Trading** - USDT-M perpetual contracts up to 125x leverage
- 💰 **Account Management** - Balance, positions, margin settings
- 📈 **Market Data** - Tickers, order book, candlesticks, funding rates
- 🎯 **Advanced Orders** - Trigger orders, TP/SL, conditional orders
- 🤖 **AI Integration** - Log AI trading decisions
- 🔌 **Universal Compatibility** - Works with any AI agent supporting shell commands

## Environment Variables

| Variable | Description | Required |
|----------|-------------|----------|
| `WEEX_API_KEY` | API Key from WEEX | Yes |
| `WEEX_API_SECRET` | API Secret | Yes |
| `WEEX_PASSPHRASE` | API Passphrase | Yes |
| `WEEX_BASE_URL` | API base URL | No (default: https://api-contract.weex.com) |

## Authentication

```bash
API_KEY="${WEEX_API_KEY}"
SECRET="${WEEX_API_SECRET}"
PASSPHRASE="${WEEX_PASSPHRASE}"
BASE_URL="${WEEX_BASE_URL:-https://api-contract.weex.com}"

TIMESTAMP=$(python3 -c "import time; print(int(time.time() * 1000))")

# Generate signature
generate_signature() {
  local method="$1"
  local path="$2"
  local body="$3"
  local message="${TIMESTAMP}${method}${path}${body}"
  echo -n "$message" | openssl dgst -sha256 -hmac "$SECRET" -binary | base64
}
```

---

# Market Data Endpoints (No Auth)

## Get Server Time

```bash
curl -s "${BASE_URL}/capi/v2/market/time" | jq '.'
```

## Get All Contracts Info

```bash
curl -s "${BASE_URL}/capi/v2/market/contracts" | jq '.data[] | {symbol: .symbol, baseCoin: .underlying_index, quoteCoin: .quote_currency, contractVal: .contract_val, minLeverage: .minLeverage, maxLeverage: .maxLeverage, tickSize: .tick_size, sizeIncrement: .size_increment}'
```

## Get Single Contr...

# WEEX Futures Trading Skill 🔵

An **Open AI Agent Skill** for trading USDT-margined perpetual futures on [WEEX](https://www.weex.com) 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

| Agent | Status | Notes |
|-------|--------|-------|
| Claude (Anthropic) | ✅ Fully Supported | Claude Code, API |
| GPT-4 (OpenAI) | ✅ Fully Supported | ChatGPT, API with code interpreter |
| Gemini (Google) | ✅ Fully Supported | Gemini Pro, API |
| LLaMA (Meta) | ✅ Fully Supported | With code execution capability |
| Mistral | ✅ Fully Supported | With code execution capability |
| Other LLMs | ✅ Compatible | Any agent supporting bash/curl |

## Installation

### As AI Agent Skill

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

```bash
# 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

```bash
# 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...