kucoin-trader

# KuCoin Trader 🟢

Professional automated trading system for KuCoin (KC) - a global cryptocurrency exchange.

## 🚀 Quick Start

### Setup Credentials

Save to `~/.openclaw/credentials/kucoin.json`:
```json
{
  "apiKey": "YOUR_API_KEY",
  "secretKey": "YOUR_SECRET_KEY",
  "passphrase": "YOUR_PASSPHRASE"
}
```

### Environment Variables (alternative)
```bash
export KUCOIN_API_KEY="your_api_key"
export KUCOIN_SECRET_KEY="your_secret_key"
export KUCOIN_PASSPHRASE="your_passphrase"
```

## 📊 Basic Queries

| Command | Description |
|---------|-------------|
| `node scripts/accounts.js` | List all account balances |
| `node scripts/market.js --symbol BTC-USDT` | Get current price |
| `node scripts/query.js` | Query all active orders |

## 💰 Asset Transfer

Supported types: `main`, `trade`, `margin`, `isolated`, `futures`

```bash
# Main to Trade
node scripts/transfer.js --from main --to trade --currency USDT --amount 100

# Trade to Futures
node scripts/transfer.js --from trade --to futures --currency USDT --amount 100

# Any account transfer
node scripts/transfer.js --from <FROM> --to <TO> --currency <CURRENCY> --amount <AMOUNT>
```

## ⚡ Spot Trading

```bash
# Market Buy
node scripts/spot.js trade --symbol BTC-USDT --side buy --type market --size 0.001

# Limit Buy
node scripts/spot.js trade --symbol ETH-USDT --side buy --type limit --price 2500 --size 0.1

# Market Sell
node scripts/spot.js trade --symbol BTC-USDT --side sell --type market --size 0.001

# Limit Sell
node scripts/spot.js trade --symbol ETH-USDT --side sell --type limit --price 3000 --size 0.1

# Query orders
node scripts/spot.js orders --symbol BTC-USDT

# Cancel order
node scripts/spot.js cancel --orderId xxx
```

## 🏦 Margin Trading (Cross Margin & Isolated Margin)

```bash
# --- Cross Margin (全仓杠杆) ---
# Check borrowable
node scripts/margin.js borrowable --currency USDT

# Borrow
node scripts/margin.js borrow --currency USDT --amount 100

# Repay
node scripts/margin.js repay --currency USD...

This software is provided "AS IS" without warranty of any kind. Cryptocurrency trading involves substantial risk and may result in the loss of your entire capital. This tool is for educational and informational purposes only and does not constitute financial or trading advice. The author assumes no liability for any damages or losses arising from the use of this software.