starchild-ai-agent/@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

| Error | Likely Cause | Fix | |-------|-------------|-----| | Missing dependency: ccxt | ccxt not installed | pip install --break-system-packages ccxt | | Missing API credentials for binance | BINANCE_API_KEY/BINANCE_SECRET not set | Add to workspace/.env | | Invalid API Key | Wrong key in .env | Re-check BINANCE_API_KEY | | Timestamp for this request | Clock skew | Sync system clock | | MIN_NOTIONAL | Order too small | Increase amount (min ~$10 USDT) | | Insufficient balance | Not enough funds | Check balance first | | OCO price rules violation | Price ordering wrong | limit > current price > stop for sell OCO |