binance – OpenClaw Skill

---

name: binance description: Binance exchange integration. Trade spot, futures, and manage portfolio on the world's largest crypto exchange. metadata: {"clawdbot":{"emoji":"🟡","always":true,"requires":{"bins":["curl","jq"]}}}

Binance 🟡

World's largest cryptocurrency exchange. Trade 600+ cryptocurrencies with deep liquidity.

Environment Variables

Variable	Description	Required
BINANCE_API_KEY	API Key from Binance	Yes
BINANCE_SECRET	API Secret	Yes

💎 Referral Configuration

This skill uses a referral ID to earn commission on trading fees.

Variable	Value	Description
REFERRAL_ID	CYBERPAY	Referral ID for fee sharing

Commission Structure:

• Standard: Up to 20% of trading fees
• With 500+ BNB: Up to 50% of trading fees
• Lifetime commission on referred users

💡 Users who sign up through this skill automatically use the referral ID!

Features

• 📈 Spot Trading - 600+ trading pairs
• 📊 Futures Trading - Up to 125x leverage
• 💰 Earn - Staking, savings, liquidity farming
• 🔄 Convert - Simple token swaps
• 📱 Portfolio - Track all assets

API Base URLs

• Spot: https://api.binance.com
• Futures: https://fapi.binance.com
• Testnet: https://testnet.binance.vision

Authentication

API_KEY="${BINANCE_API_KEY}"
SECRET="${BINANCE_SECRET}"

# Generate signature
generate_signature() {
  local query_string="$1"
  echo -n "$query_string" | openssl dgst -sha256 -hmac "$SECRET" | cut -d' ' -f2
}

TIMESTAMP=$(date +%s%3N)

Get Account Info

QUERY="timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s "https://api.binance.com/api/v3/account?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '{
    balances: [.balances[] | select(.free != "0.00000000" or .locked != "0.00000000")]
  }'

Get Price

SYMBOL="BTCUSDT"

curl -s "https://api.binance.com/api/v3/ticker/price?symbol=${SYMBOL}" | jq '.'

Get Order Book

curl -s "https://api.binance.com/api/v3/depth?symbol=${SYMBOL}&limit=10" | jq '{
  bids: .bids[:5],
  asks: .asks[:5]
}'

Place Spot Order

SYMBOL="BTCUSDT"
SIDE="BUY"  # BUY or SELL
TYPE="LIMIT"  # LIMIT, MARKET, STOP_LOSS, etc.
QUANTITY="0.001"
PRICE="40000"

QUERY="symbol=${SYMBOL}&side=${SIDE}&type=${TYPE}&timeInForce=GTC&quantity=${QUANTITY}&price=${PRICE}&timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s -X POST "https://api.binance.com/api/v3/order?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.'

Place Market Order

SYMBOL="ETHUSDT"
SIDE="BUY"
QUANTITY="0.1"

QUERY="symbol=${SYMBOL}&side=${SIDE}&type=MARKET&quantity=${QUANTITY}&timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s -X POST "https://api.binance.com/api/v3/order?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.'

Get Open Orders

QUERY="timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s "https://api.binance.com/api/v3/openOrders?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.[] | {symbol: .symbol, side: .side, price: .price, quantity: .origQty, status: .status}'

Cancel Order

SYMBOL="BTCUSDT"
ORDER_ID="12345678"

QUERY="symbol=${SYMBOL}&orderId=${ORDER_ID}&timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s -X DELETE "https://api.binance.com/api/v3/order?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.'

Get Trade History

SYMBOL="BTCUSDT"

QUERY="symbol=${SYMBOL}&timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s "https://api.binance.com/api/v3/myTrades?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.[-10:] | .[] | {symbol: .symbol, price: .price, qty: .qty, time: .time}'

Futures: Get Position

QUERY="timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s "https://fapi.binance.com/fapi/v2/positionRisk?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.[] | select(.positionAmt != "0") | {symbol: .symbol, positionAmt: .positionAmt, entryPrice: .entryPrice, unrealizedProfit: .unRealizedProfit}'

Convert (Simple Swap)

FROM_ASSET="USDT"
TO_ASSET="BTC"
FROM_AMOUNT="100"

# Get quote
QUERY="fromAsset=${FROM_ASSET}&toAsset=${TO_ASSET}&fromAmount=${FROM_AMOUNT}&timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s -X POST "https://api.binance.com/sapi/v1/convert/getQuote?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.'

Popular Trading Pairs

Pair	Description
BTCUSDT	Bitcoin / Tether
ETHUSDT	Ethereum / Tether
BNBUSDT	BNB / Tether
SOLUSDT	Solana / Tether
XRPUSDT	XRP / Tether
DOGEUSDT	Dogecoin / Tether

Order Types

Type	Description
LIMIT	Limit order at specific price
MARKET	Market order at current price
STOP_LOSS	Stop loss order
STOP_LOSS_LIMIT	Stop loss limit order
TAKE_PROFIT	Take profit order
TAKE_PROFIT_LIMIT	Take profit limit order

Safety Rules

1. ALWAYS display order details before execution
2. VERIFY trading pair and amount
3. CHECK account balance before trading
4. WARN about leverage risks in futures
5. NEVER execute without user confirmation

Error Handling

Error	Cause	Solution
-1013	Invalid quantity	Check lot size filters
-2010	Insufficient balance	Check account balance
-1021	Timestamp outside recvWindow	Sync system time

Links

• Binance API Docs
• Binance
• Testnet

Binance 🟡

World's largest crypto exchange skill for Clawdbot.

Features

• 📈 Spot Trading - 600+ trading pairs
• 📊 Futures Trading - Up to 125x leverage
• 💰 Earn - Staking, savings, liquidity farming
• 🔄 Convert - Simple token swaps
• 📱 Portfolio - Track all assets

Installation

clawdhub install binance

Configuration

export BINANCE_API_KEY="your-api-key"
export BINANCE_SECRET="your-secret"

Usage Examples

"Check my Binance balance"
"Buy 0.1 ETH at market price"
"Place limit order to buy BTC at $40000"
"Show my open orders"
"Get BTC price"

Referral

Users who sign up through this skill get fee discounts!

License

MIT