# binance-futures-signal-bot

A skill that walks your agent through setting up a futures trading bot for Binance, Bybit and OKX, fed by Telegram, TradingView or a custom API.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 600 installs · ★ 88
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/binance-futures-signal-bot/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/binance-futures-signal-bot

## What it does

This skill gives the agent a working path to a futures trading bot on Binance, Bybit and OKX. Signals arrive from a Telegram channel, a TradingView webhook or your own API endpoint, and the bot turns them into orders with a chosen leverage, position sizing and a trailing stop. Everything is driven by `config.json` and an interactive `python main.py` menu that covers dependency install, settings, signal sources, auto trading, strategy config, position manager and the P&L dashboard.

Four strategies ship in the config: EMA crossover, RSI divergence, Bollinger breakout and MACD momentum. Each can be toggled on its own, and when several run together the bot picks the strongest signal and drops the conflicting ones. Keep secrets out of the file — the README points to environment variables such as `BINANCE_API_KEY`, `BINANCE_API_SECRET`, `OKX_PASSPHRASE` and `TELEGRAM_BOT_TOKEN`, and `config.json` is gitignored.

You need Python 3.10+ plus the packages in `requirements.txt`: `rich`, `python-binance`, `ccxt`, `pandas`, `ta`, `websockets`, `cryptography`. TradingView alerts only reach the bot if port `8080` is open and the alert webhook points at `/webhook` on your server. Leverage is configurable up to 125x, yet the sample config sits at 5x and the parameter notes suggest starting at 2–5x — with no futures-enabled API keys the bot places nothing at all, so run it against testnet first.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill binance-futures-signal-bot -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/binance-futures-signal-bot/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/binance-futures-signal-bot/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill binance-futures-signal-bot -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/binance-futures-signal-bot/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill binance-futures-signal-bot -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/binance-futures-signal-bot/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills binance-futures-signal-bot
```

2. **Manually: put the files in place**
- File: `.github/skills/binance-futures-signal-bot/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill binance-futures-signal-bot -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/binance-futures-signal-bot
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/binance-futures-signal-bot/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill binance-futures-signal-bot -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/binance-futures-signal-bot/SKILL.md

## When to use it
- wire Telegram channel signals into live order execution
- receive TradingView webhook alerts and act on them
- set leverage and per-trade position size as a share of balance
- add a trailing stop and a daily loss cap
- debug a bot that reads signals but never trades

## Example prompts
- Set up the Binance futures bot with keys from environment variables, 5x leverage and BTCUSDT plus ETHUSDT
- Connect the Telegram channel as the signal source and start auto trading
- Enable the EMA crossover strategy with 9 and 21 periods and open the P&L dashboard

## Similar
- [remotion-render](https://affpapa.org/en/nevibecode/skills/remotion-render.md) — skill · 3 installs
- [recipe-share-event-materials](https://affpapa.org/en/nevibecode/skills/recipe-share-event-materials.md) — skill · 29700 installs
- [blogwatcher](https://affpapa.org/en/nevibecode/skills/blogwatcher.md) — skill · 5400 installs
- [ego-browser](https://affpapa.org/en/nevibecode/skills/ego-browser.md) — skill · 12200 installs
- [composio](https://affpapa.org/en/nevibecode/skills/composio.md) — skill · 8100 installs
- [remote-browser](https://affpapa.org/en/nevibecode/skills/remote-browser.md) — skill · 4700 installs

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 139 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md