binance-plugin

binance-skills — Binance API CLI & AI Trading Skills

Binance CLI for the full Financial Trading REST API. Trade spot, futures, margin, algo from the command line — or let AI assistants (Cursor, Claude, Codex) execute Binance API calls for you.

One command to check prices, place orders, manage funds, trade futures. No boilerplate, no docs diving. Binance API command line and Binance trading CLI in a single tool.

Why This Exists

AI coding assistants (Claude Code, Cursor, Codex, OpenCode) are getting powerful, but they can't trade crypto out of the box.

This project wraps Binance Financial Trading REST API endpoints (spot, futures, margin, wallet, algo, convert, copy trading, institutional loan) into a single Binance API CLI with SKILL.md skill descriptors. Use it as a Binance command line tool yourself, or let AI read the skills and execute trades in plain English.

Get Started in 30 Seconds

# 1. Install (CLI published on npm)
npm install -g binance-trader-cli
# Or from source: cd cli && npm install && npm link

# 2. Try it (no API key needed)
binance spot ping
binance spot ticker --symbol BTCUSDT
binance spot klines --symbol ETHUSDT --interval 4h --limit 10

# 3. Unlock everything with your API key
cat > .env << 'EOF'
BINANCE_API_KEY="your-key"
BINANCE_SECRET_KEY="your-secret"
EOF

binance spot account
binance spot order --symbol BTCUSDT --side BUY --type MARKET --quoteOrderQty 100

9 Skill Modules

┌──────────────────────────────────────────────────────────────┐
│                       binance CLI                            │
├──────────────┬──────────────┬────────────────┬───────────────┤
│  Trading     │  Market      │  Funds         │  Advanced     │
├──────────────┼──────────────┼────────────────┼───────────────┤
│  spot        │  (in spot)   │  wallet        │  algo         │
│  futures     │              │                │  copy-trading │
│  margin      │              │                │  convert      │
│              │              │                │  alpha        │
│              │              │                │  inst. loan   │
└──────────────┴──────────────┴────────────────┴───────────────┘

Trading

Market Data (within spot & futures)

Fund Management

Advanced

Command Format

binance <module> <command> [options]

Option names match the Binance API docs exactly — no extra mapping to memorize.

Global options:

--apiKey        API Key (or set via .env)
--secretKey     Secret Key
--baseUrl       Custom spot endpoint (default: https://api.binance.com)
--futuresUrl    Custom futures endpoint (default: https://fapi.binance.com)
--testnet       Enable testnet mode

Real-World Scenarios

Scenario 1 — Research, Then Trade

# Current BTC price
binance spot ticker --symbol BTCUSDT

# Last 24 hourly candles
binance spot klines --symbol BTCUSDT --interval 1h --limit 24

# Futures funding rate
binance futures funding-rate --symbol BTCUSDT

# Place a limit buy
binance spot order --symbol BTCUSDT --side BUY --type LIMIT --timeInForce GTC --quantity 0.001 --price 60000

Scenario 2 — Portfolio Overview

# Spot account
binance spot account --omitZeroBalances

# Futures positions
binance futures position-risk

# Wallet balance
binance wallet balance

# Transfer 1000 USDT from spot to futures
binance wallet transfer --type MAIN_UMFUTURE --asset USDT --amount 1000

Scenario 3 — Futures Trading

# Set leverage
binance futures leverage --symbol BTCUSDT --leverage 10

# Open long position
binance futures order --symbol BTCUSDT --side BUY --type MARKET --quantity 0.01

# Set stop-loss
binance futures order --symbol BTCUSDT --side SELL --type STOP_MARKET --stopPrice 58000 --closePosition true

# Set take-profit
binance futures order --symbol BTCUSDT --side SELL --type TAKE_PROFIT_MARKET --stopPrice 75000 --closePosition true

Scenario 4 — Algo Execution

# TWAP buy over 5 minutes
binance algo futures-twap --symbol BTCUSDT --side BUY --quantity 1 --duration 300

# Check running algo orders
binance algo futures-open-orders

# VP sell with high urgency
binance algo futures-vp --symbol BTCUSDT --side SELL --quantity 0.5 --urgency HIGH

AI Assistant Integration

Out-of-the-box support for 10+ AI coding assistants. Add the project to your workspace and start chatting:

> What's the current BTC price?
> Buy 100 USDT worth of BTC at market price
> How much balance do I have?
> Open a 10x long on ETH futures

Security

• API credentials are stored locally only — in .env files or environment variables, never sent to third-party servers
• All API requests are signed with HMAC-SHA256; your secret key never appears in any request
• .env is included in .gitignore by default
• Recommended: use a read-only API key for market queries, and a separate key with IP whitelist for trading

How Authentication Works

Binance uses HMAC-SHA256 signature authentication:

queryString = param1=value1&param2=value2&timestamp=1234567890
signature   = HMAC-SHA256(queryString, secretKey).hex()

Each request automatically includes:

Header:  X-MBX-APIKEY: your-api-key
Query:   ...&signature=computed_signature

The CLI handles all of this internally. Just configure .env and go.

Links

• npm: binance-trader-cli — Install: npm install -g binance-trader-cli
• Binance API Documentation
• Apply for API Key
• Testnet

中文说明

Binance API 命令行工具 — 完整覆盖币安金融交易 REST API（现货、合约、杠杆、钱包、算法单、闪兑等）。安装：npm install -g binance-trader-cli。支持 Cursor、Claude、Codex 等 AI 编程助手直接调用。

Suggested GitHub Topics

For better discoverability, add these topics to your GitHub repo (Settings → General → Topics):

binance binance-api binance-cli cli trading crypto trading-bot rest-api cursor ai-assistant claude algorithmic-trading 币安 中文

License

Apache-2.0