{"id":"1a8bfbd2-f24c-4fc4-afd7-97d5f5e920be","slug":"binance-plugin","kind":"skill","name":"binance-plugin","summary":"binance trade cli, plugin, agents, skills,","owner":"open-crab-ai","repoUrl":"https://github.com/open-crab-ai/binance-plugin","license":"Apache-2.0","licenseTier":"permissive","trust":"community","stars":1,"match":null,"fewStars":true,"format":"skill","createdAt":"2026-03-08T16:26:18.000Z","addedAt":"2026-10-22T00:40:57.004Z","logoUrl":"https://avatars.githubusercontent.com/u/266427223?u=f9b29605662b96938378e57a69b9b619ec72d4b2&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["writing"],"tags":[],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-23T09:17:05.171Z","sample":false,"url":"https://conduits.dev/tools/binance-plugin","language":"JavaScript","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# binance-skills — Binance API CLI & AI Trading Skills\n\n> **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.\n\nOne 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.\n\n---\n\n## Why This Exists\n\nAI coding assistants (Claude Code, Cursor, Codex, OpenCode) are getting powerful, but they can't trade crypto out of the box.\n\nThis 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.\n\n---\n\n## Get Started in 30 Seconds\n\n```bash\n# 1. Install (CLI published on npm)\nnpm install -g binance-trader-cli\n# Or from source: cd cli && npm install && npm link\n\n# 2. Try it (no API key needed)\nbinance spot ping\nbinance spot ticker --symbol BTCUSDT\nbinance spot klines --symbol ETHUSDT --interval 4h --limit 10\n\n# 3. Unlock everything with your API key\ncat > .env << 'EOF'\nBINANCE_API_KEY=\"your-key\"\nBINANCE_SECRET_KEY=\"your-secret\"\nEOF\n\nbinance spot account\nbinance spot order --symbol BTCUSDT --side BUY --type MARKET --quoteOrderQty 100\n```\n\n---\n\n## 9 Skill Modules\n\n```\n┌──────────────────────────────────────────────────────────────┐\n│                       binance CLI                            │\n├──────────────┬──────────────┬────────────────┬───────────────┤\n│  Trading     │  Market      │  Funds         │  Advanced     │\n├──────────────┼──────────────┼────────────────┼───────────────┤\n│  spot        │  (in spot)   │  wallet        │  algo         │\n│  futures     │              │                │  copy-trading │\n│  margin      │              │                │  convert      │\n│              │              │                │  alpha        │\n│              │              │                │  inst. loan   │\n└──────────────┴──────────────┴────────────────┴───────────────┘\n```\n\n### Trading\n\n| Module | Description | Example |\n|--------|-------------|---------|\n| **spot** | Spot orders, market data, account | `binance spot ticker --symbol BTCUSDT` |\n| **futures** | USDS-M futures orders, positions, leverage | `binance futures order --symbol BTCUSDT --side BUY --type MARKET --quantity 0.01` |\n| **margin** | Margin orders, borrow/repay, interest | `binance margin order --symbol BTCUSDT --side BUY --type MARKET --quantity 0.001` |\n\n### Market Data (within spot & futures)\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| ticker | Latest price | `binance spot ticker --symbol BTCUSDT` |\n| klines | Candlestick data | `binance spot klines --symbol BTCUSDT --interval 1h` |\n| depth | Order book | `binance spot depth --symbol BTCUSDT --limit 20` |\n| funding-rate | Futures funding rate | `binance futures funding-rate --symbol BTCUSDT` |\n\n### Fund Management\n\n| Module | Description | Example |\n|--------|-------------|---------|\n| **wallet** | Balances, deposits, withdrawals, transfers, dust | `binance wallet balance` |\n\n### Advanced\n\n| Module | Description | Example |\n|--------|-------------|---------|\n| **algo** | TWAP/VP algorithmic orders (spot & futures) | `binance algo futures-twap --symbol BTCUSDT --side BUY --quantity 1 --duration 300` |\n| **copy-trading** | Lead trader status, symbol whitelist | `binance copy-trading user-status` |\n| **convert** | Flash swap / token conversion | `binance convert get-quote --fromAsset USDT --toAsset BTC --fromAmount 100` |\n| **alpha** | Alpha token trading | `binance alpha ticker --symbol TOKENUSDT` |\n| **institutional-loan** | Institutional loans, LTV management | `binance institutional-loan ongoing-orders` |\n\n---\n\n## Command Format\n\n```\nbinance <module> <command> [options]\n```\n\nOption names match the Binance API docs exactly — no extra mapping to memorize.\n\n**Global options:**\n\n```\n--apiKey        API Key (or set via .env)\n--secretKey     Secret Key\n--baseUrl       Custom spot endpoint (default: https://api.binance.com)\n--futuresUrl    Custom futures endpoint (default: https://fapi.binance.com)\n--testnet       Enable testnet mode\n```\n\n---\n\n## Real-World Scenarios\n\n### Scenario 1 — Research, Then Trade\n\n```bash\n# Current BTC price\nbinance spot ticker --symbol BTCUSDT\n\n# Last 24 hourly candles\nbinance spot klines --symbol BTCUSDT --interval 1h --limit 24\n\n# Futures funding rate\nbinance futures funding-rate --symbol BTCUSDT\n\n# Place a limit buy\nbinance spot order --symbol BTCUSDT --side BUY --type LIMIT --timeInForce GTC --quantity 0.001 --price 60000\n```\n\n### Scenario 2 — Portfolio Overview\n\n```bash\n# Spot account\nbinance spot account --omitZeroBalances\n\n# Futures positions\nbinance futures position-risk\n\n# Wallet balance\nbinance wallet balance\n\n# Transfer 1000 USDT from spot to futures\nbinance wallet transfer --type MAIN_UMFUTURE --asset USDT --amount 1000\n```\n\n### Scenario 3 — Futures Trading\n\n```bash\n# Set leverage\nbinance futures leverage --symbol BTCUSDT --leverage 10\n\n# Open long position\nbinance futures order --symbol BTCUSDT --side BUY --type MARKET --quantity 0.01\n\n# Set stop-loss\nbinance futures order --symbol BTCUSDT --side SELL --type STOP_MARKET --stopPrice 58000 --closePosition true\n\n# Set take-profit\nbinance futures order --symbol BTCUSDT --side SELL --type TAKE_PROFIT_MARKET --stopPrice 75000 --closePosition true\n```\n\n### Scenario 4 — Algo Execution\n\n```bash\n# TWAP buy over 5 minutes\nbinance algo futures-twap --symbol BTCUSDT --side BUY --quantity 1 --duration 300\n\n# Check running algo orders\nbinance algo futures-open-orders\n\n# VP sell with high urgency\nbinance algo futures-vp --symbol BTCUSDT --side SELL --quantity 0.5 --urgency HIGH\n```\n\n---\n\n## AI Assistant Integration\n\nOut-of-the-box support for **10+ AI coding assistants**. Add the project to your workspace and start chatting:\n\n```\n> What's the current BTC price?\n> Buy 100 USDT worth of BTC at market price\n> How much balance do I have?\n> Open a 10x long on ETH futures\n```\n\n| Platform | Config File | How It Works |\n|----------|-------------|--------------|\n| **Claude Code** | [CLAUDE.md](CLAUDE.md) + [.claude-plugin/](.claude-plugin) | Auto-discovers skills on startup. Also supports marketplace install. |\n| **OpenClaw** | [.openclaw/](.openclaw) | Publish to ClawHub marketplace or install from source. See [install guide](.openclaw/INSTALL.md). |\n| **Cursor** | [.cursor-plugin/](.cursor-plugin) | Reads SKILL.md files from [skills/](skills) directory automatically. |\n| **GitHub Copilot** | [.github/copilot-instructions.md](.github/copilot-instructions.md) | Copilot reads instructions file for project context. |\n| **Windsurf** | [.windsurf/rules/](.windsurf/rules) | Rules are loaded automatically with trigger: always. |\n| **Cline** | [.clinerules](.clinerules) | Cline reads the rules file on session start. |\n| **Continue.dev** | [.continue/config.yaml](.continue/config.yaml) | Context and rules injected via config. |\n| **Codex CLI** | [.codex/](.codex) + [AGENTS.md](AGENTS.md) | Clone + symlink for native skill discovery. See [install guide](.codex/INSTALL.md). |\n| **OpenCode** | [.opencode/](.opencode) + [AGENTS.md](AGENTS.md) | Plugin + symlink for skill injection. See [install guide](.opencode/INSTALL.md). |\n| **Aider** | [CONVENTIONS.md](CONVENTIONS.md) | Aider reads conventions file for project context. |\n\n---\n\n## Security\n\n* API credentials are stored **locally only** — in `.env` files or environment variables, never sent to third-party servers\n* All API requests are signed with HMAC-SHA256; your secret key never appears in any request\n* `.env` is included in `.gitignore` by default\n* Recommended: use a **read-only** API key for market queries, and a separate key with IP whitelist for trading\n\n---\n\n## How Authentication Works\n\nBinance uses HMAC-SHA256 signature authentication:\n\n```\nqueryString = param1=value1&param2=value2&timestamp=1234567890\nsignature   = HMAC-SHA256(queryString, secretKey).hex()\n```\n\nEach request automatically includes:\n\n```\nHeader:  X-MBX-APIKEY: your-api-key\nQuery:   ...&signature=computed_signature\n```\n\nThe CLI handles all of this internally. Just configure `.env` and go.\n\n---\n\n## Links\n\n* [npm: binance-trader-cli](https://www.npmjs.com/package/binance-trader-cli) — Install: `npm install -g binance-trader-cli`\n* [Binance API Documentation](https://developers.binance.com/en/)\n* [Apply for API Key](https://www.binance.com/en/my/settings/api-management)\n* [Testnet](https://testnet.binance.vision/)\n\n---\n\n## 中文说明\n\n**Binance API 命令行工具** — 完整覆盖币安金融交易 REST API（现货、合约、杠杆、钱包、算法单、闪兑等）。安装：`npm install -g binance-trader-cli`。支持 Cursor、Claude、Codex 等 AI 编程助手直接调用。\n\n## Suggested GitHub Topics\n\nFor better discoverability, add these topics to your GitHub repo (Settings → General → Topics):\n\n`binance` `binance-api` `binance-cli` `cli` `trading` `crypto` `trading-bot` `rest-api` `cursor` `ai-assistant` `claude` `algorithmic-trading` `币安` `中文`\n\n\n## License\n\nApache-2.0\n\n"}