How do I install the Bybit Futures skill?

Run npx skillmds@latest add modbender/bybit-futures in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bybit Futures safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bybit Futures?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bybit Futures free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bybit Futures?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bybit Futures by modbender — Agent Skill

Name: Bybit Futures
Rating: 4.5 (4 reviews)
Author: modbender

Bybit Futures

Complete Bybit USDT perpetual futures trading system with risk management, paper trading, and live execution. Use when building a crypto futures trading bot, connecting to Bybit API, implementing stop-loss/take-profit, managing leverage and position sizing, paper trading strategies, backtesting, or deploying a WebSocket-based real-time trading system. Supports EMA crossover, RSI, and custom strategy templates.

modbender Updated Sep 9, 2026 12 repo stars

File contents

Bybit Futures Trading System

Complete trading infrastructure for Bybit USDT perpetual futures contracts.

Quick Start

Install dependencies: pip install ccxt websockets numpy requests
Copy scripts/config_template.py → config.py, fill in API keys
Run paper trading: python scripts/paper_trading_ws.py
When validated, switch to live: python scripts/live_trading.py

Architecture

config.py          ← API keys + risk parameters
risk_manager.py    ← Position sizing, daily loss limits, max positions
paper_trading_ws.py ← WebSocket real-time paper trading
live_trading.py    ← Live execution (same logic, real orders)
backtest.py        ← Historical backtesting engine

Risk Management

All trades enforced by risk_manager.py:

Max position: configurable % of capital per trade (default 20%)
Max leverage: configurable (default 5x)
Stop loss: automatic per-trade (default 3%)
Take profit: automatic per-trade (default 6%, 2:1 R/R)
Daily loss limit: halt trading after X% daily drawdown (default 10%)
Max concurrent positions: configurable (default 3)

Included Strategies

EMA Crossover (ETH)

EMA(12) crosses above EMA(26) → long
EMA(12) crosses below EMA(26) → short
Best on: ETH/USDT 1h timeframe

RSI Mean Reversion (SOL, HYPE, PEPE)

RSI(14) crosses up from below 30 → long
RSI(14) crosses down from above 70 → short
Best on: SOL, HYPE (73% WR), 1000PEPE (53% WR) 1h timeframe
Backtested: HYPE +$339, PEPE +$210 on 90-day 1h data

Custom Strategy Template

See references/custom_strategy.md for adding your own signals.

WebSocket Real-Time Engine

The paper/live trading engine uses Bybit's WebSocket v5 API:

Ticker subscription: millisecond-level price updates for SL/TP
Kline subscription: signal calculation on candle close only
Auto-reconnect: 5s retry on disconnect
State persistence: saves every 5 minutes to JSON

Deployment

Recommended: systemd service on a VPS.

# Create service file
sudo tee /etc/systemd/system/paper-trading.service << 'EOF'
[Unit]
Description=Paper Trading Bot (WebSocket)
After=network.target

[Service]
Type=simple
WorkingDirectory=/root/trading
ExecStart=/usr/bin/python3 paper_trading_ws.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl enable --now paper-trading

Telegram Notifications

Built-in Telegram push for all events:

Position opened/closed
Stop loss / take profit hit
6-hourly summary reports
Error alerts

Set TG_BOT_TOKEN and TG_CHAT_ID in config.

Files

scripts/config_template.py — Configuration template
scripts/risk_manager.py — Risk management engine
scripts/paper_trading_ws.py — WebSocket paper trading bot
scripts/live_trading.py — Live trading bot
scripts/backtest.py — Backtesting engine
references/custom_strategy.md — Guide for adding custom strategies
references/bybit_api_notes.md — Bybit API gotchas and tips

---name: bybit-futuresdescription: Complete Bybit USDT perpetual futures trading system with risk management, paper trading, and live execution. Use when building a crypto futures trading bot, connecting to Bybit API, implementing stop-loss/take-profit, managing leverage and position sizing, paper trading strategies, backtesting, or deploying a WebSocket-based real-time trading system. Supports EMA crossover, RSI, and custom strategy templates.--- # Bybit Futures Trading System Complete trading infrastructure for Bybit USDT perpetual futures contracts. ## Quick Start 1. Install dependencies: `pip install ccxt websockets numpy requests` 2. Copy `scripts/config_template.py` → `config.py`, fill in API keys 3. Run paper trading: `python scripts/paper_trading_ws.py` 4. When validated, switch to live: `python scripts/live_trading.py` ## Architecture ``` config.py ← API keys + risk parameters risk_manager.py ← Position sizing, daily loss limits, max positions paper_trading_ws.py ← WebSocket real-time paper trading live_trading.py ← Live execution (same logic, real orders) backtest.py ← Historical backtesting engine ``` ## Risk Management All trades enforced by `risk_manager.py`: - **Max position**: configurable % of capital per trade (default 20%) - **Max leverage**: configurable (default 5x) - **Stop loss**: automatic per-trade (default 3%) - **Take profit**: automatic per-trade (default 6%, 2:1 R/R) - **Daily loss limit**: halt trading after X% daily drawdown (default 10%) - **Max concurrent positions**: configurable (default 3) ## Included Strategies ### EMA Crossover (ETH) - EMA(12) crosses above EMA(26) → long - EMA(12) crosses below EMA(26) → short - Best on: ETH/USDT 1h timeframe ### RSI Mean Reversion (SOL, HYPE, PEPE) - RSI(14) crosses up from below 30 → long - RSI(14) crosses down from above 70 → short - Best on: SOL, HYPE (73% WR), 1000PEPE (53% WR) 1h timeframe - Backtested: HYPE +$339, PEPE +$210 on 90-day 1h data ### Custom Strategy Template See `references/custom_strategy.md` for adding your own signals. ## WebSocket Real-Time Engine The paper/live trading engine uses Bybit's WebSocket v5 API: - **Ticker subscription**: millisecond-level price updates for SL/TP - **Kline subscription**: signal calculation on candle close only - **Auto-reconnect**: 5s retry on disconnect - **State persistence**: saves every 5 minutes to JSON ## Deployment Recommended: systemd service on a VPS. ```bash # Create service file sudo tee /etc/systemd/system/paper-trading.service << 'EOF' [Unit] Description=Paper Trading Bot (WebSocket) After=network.target [Service] Type=simple WorkingDirectory=/root/trading ExecStart=/usr/bin/python3 paper_trading_ws.py Restart=always RestartSec=10 [Install] WantedBy=multi-user.target EOF sudo systemctl enable --now paper-trading ``` ## Telegram Notifications Built-in Telegram push for all events: - Position opened/closed - Stop loss / take profit hit - 6-hourly summary reports - Error alerts Set `TG_BOT_TOKEN` and `TG_CHAT_ID` in config. ## Files - `scripts/config_template.py` — Configuration template - `scripts/risk_manager.py` — Risk management engine - `scripts/paper_trading_ws.py` — WebSocket paper trading bot - `scripts/live_trading.py` — Live trading bot - `scripts/backtest.py` — Backtesting engine - `references/custom_strategy.md` — Guide for adding custom strategies - `references/bybit_api_notes.md` — Bybit API gotchas and tips

Frequently asked questions