@349/binance

Binance Skill

Trade on Binance — the world's largest CEX — directly from Starchild.

Supports Spot and USDM Futures. Uses the bundled scripts/ccex_core.py engine under the hood.

Setup

1. Get your Binance API Keys

1. Log in to binance.com
2. Go to Profile → API Management
3. Create a new API key — enable Spot & Margin Trading and Futures Trading
4. Save your API key and secret

2. Add to environment

Add to workspace/.env:

BINANCE_API_KEY=your_api_key_here
BINANCE_SECRET=your_secret_here

3. Install dependencies

pip install --break-system-packages ccxt

4. Optional but recommended (persist across restarts)

grep -q "pip install --break-system-packages ccxt" workspace/setup.sh || \
  echo "pip install --break-system-packages ccxt" >> workspace/setup.sh

What You Can Do

Market Data (No API key needed)

• Get current price / ticker
• View orderbook (bids & asks)
• Candlestick OHLCV data
• List all available markets

Account (API key required)

• Check spot and futures balances
• View open orders
• View order history
• View open futures positions

Trading (API key required)

• Market orders
• Limit orders
• Stop market / stop limit orders
• Take profit orders
• Trailing stop orders (delta-based)
• OCO orders (native Binance support)
• Futures orders with reduce-only

Workflow

ALWAYS follow this order:

1. Check balance before trading
2. Get current price / ticker
3. Place order
4. Confirm order via open orders or history

How to Execute

All actions run via the bundled engine. Use bash to call:

python3 skills/binance/scripts/ccex_core.py <action> --exchange binance [options]

Examples

Get BTC/USDT price:

python3 skills/binance/scripts/ccex_core.py ticker --exchange binance --symbol BTC/USDT

Check balances:

python3 skills/binance/scripts/ccex_core.py balance --exchange binance

Buy 0.001 BTC at market:

python3 skills/binance/scripts/ccex_core.py order --exchange binance \
  --symbol BTC/USDT --side buy --type market --amount 0.001

Place limit buy at $90,000:

python3 skills/binance/scripts/ccex_core.py order --exchange binance \
  --symbol BTC/USDT --side buy --type limit --amount 0.001 --price 90000

Stop loss at $85,000:

python3 skills/binance/scripts/ccex_core.py order --exchange binance \
  --symbol BTC/USDT --side sell --type stop --amount 0.001 --stop_price 85000

Trailing stop (500 BIPS = 5%):

python3 skills/binance/scripts/ccex_core.py order --exchange binance \
  --symbol BTC/USDT --side sell --type stop --amount 0.001 --trailing_delta 500

OCO order — limit sell at $100k, stop at $85k:

python3 skills/binance/scripts/ccex_core.py oco --exchange binance \
  --symbol BTC/USDT --side sell --amount 0.001 \
  --price 100000 --stop_price 85000 --stop_limit_price 84900

Futures: Long 0.01 BTC on Binance USDM:

python3 skills/binance/scripts/ccex_core.py order --exchange binance \
  --symbol BTC/USDT --side buy --type market --amount 0.01 --futures

Cancel an order:

python3 skills/binance/scripts/ccex_core.py cancel --exchange binance \
  --symbol BTC/USDT --order_id 12345678

Binance-Specific Notes

OCO Orders

Binance is the only major exchange with native OCO support. An OCO places a limit order and a stop-limit order simultaneously — when one fills, the other is automatically cancelled.

Parameters:

• --price — the limit (take profit) price
• --stop_price — the stop trigger price
• --stop_limit_price — the actual limit price when stop triggers (optional, defaults to 0.1% below stop)

Futures vs Spot

Add --futures flag to any order command to route to Binance USDM Futures instead of spot.

Rate Limits

Binance rate limits: 1200 requests/minute (weight-based). CCXT handles this automatically with enableRateLimit: true.

Testnet

To use Binance testnet, set:

BINANCE_API_KEY=your_testnet_key
BINANCE_SECRET=your_testnet_secret

And modify the exchange config in skills/binance/scripts/ccex_core.py to add "test": True to options.

First-Run Sanity Check

Run this after setup to verify everything before placing trades:

python3 skills/binance/scripts/ccex_core.py ticker --exchange binance --symbol BTC/USDT

If credentials are configured, also test private access:

python3 skills/binance/scripts/ccex_core.py balance --exchange binance

Error Handling