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:

{
  "apiKey": "YOUR_API_KEY",
  "secretKey": "YOUR_SECRET_KEY",
  "passphrase": "YOUR_PASSPHRASE"
}

Environment Variables (alternative)

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

# 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

# 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)

# --- 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 USDT --amount 50

# Trade with leverage (5x)
node scripts/margin.js trade --symbol BTC-USDT --side buy --size 0.01 --leverage 5

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

# --- Isolated Margin (逐仓杠杆) ---
# Check isolated account info
node scripts/margin.js info-isolated --symbol BTC-USDT

# Check borrowable
node scripts/margin.js borrowable-isolated --symbol BTC-USDT

# Borrow/Repay
node scripts/margin.js borrow-isolated --symbol BTC-USDT --amount 0.01
node scripts/margin.js repay-isolated --symbol BTC-USDT --amount 0.01

# Trade with leverage (3x)
node scripts/margin.js trade-isolated --symbol BTC-USDT --side buy --size 0.01 --leverage 3

# Enable/Disable isolated margin
node scripts/margin.js enable
node scripts/margin.js disable

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

📈 Futures Trading

# Long
node scripts/futures.js trade --symbol BTC-USDT --side buy --size 0.001 --leverage 10

# Short
node scripts/futures.js trade --symbol BTC-USDT --side sell --size 0.001 --leverage 10

# Set leverage
node scripts/futures.js leverage --symbol BTC-USDT --leverage 20

📈 Supported Trading Pairs

Pair	Description
BTC-USDT	Bitcoin
ETH-USDT	Ethereum
SOL-USDT	Solana
XRP-USDT	XRP
DOGE-USDT	Dogecoin
ADA-USDT	Cardano
AVAX-USDT	Avalanche
KCS-USDT	KuCoin Token

🏦 Account Types

Type	Description
main	Funding Account - primary asset storage
trade	Spot Trading Account - for trading
margin	Cross Margin Account - leveraged trading (up to 5x)
isolated	Isolated Margin Account
futures	Futures Account - perpetual contracts

⚠️ Safety Rules

1. ALWAYS verify position before closing
2. ALWAYS set Stop Loss on leveraged trades
3. NEVER use leverage higher than 10x without experience
4. VERIFY pair and quantity before executing
5. CONFIRM with user before executing large orders

🔗 Links

• API Documentation
• Create Account

---

Skill for KuCoin trading with multi-account support