How do I install the Bybit Trade skill?

Run npx skillmds@latest add daviddme/bybit-trade 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 Trade safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bybit Trade?

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 Trade free to use?

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

Who published Bybit Trade?

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

Bybit Trade by daviddme — Agent Skill

Name: Bybit Trade
Rating: 4.5 (4 reviews)
Author: daviddme

Bybit Trade

Place a market entry with a native bracket stop-loss and take-profit on Bybit v5. Testnet by default. Use ONLY when the user explicitly asks to place/execute/open a trade and has already planned size with scalp-plan and confirmed risk with risk-guard. Dangerous — authenticated, touches real money on --live. Always confirm with the user before invoking.

daviddme Updated Sep 22, 2026

File contents

bybit-trade

Authenticated bracket-order execution for Bybit v5 linear perps. Calls risk-guard check as a subprocess before every order and aborts on any non-zero exit. Testnet by default — requires BOTH --live AND BYBIT_ENV=live to route to production.

When to use

Only when the user has:

Planned size via scalp-plan
Confirmed a risk-guard session exists
Explicitly asked to place / execute / open the trade

Always echo the plan and confirm with the user before invoking.

Required env vars

BYBIT_API_KEY
BYBIT_API_SECRET
BYBIT_ENV=live is REQUIRED in addition to --live for production

Keys are never accepted on the command line. If keys are missing the script exits with a clear error.

How to run

# Dry-run (signs the request but never POSTs)
python bybit-trade/trade.py place \
  --symbol SOLUSDT --side buy --qty 11.2 \
  --sl 145.97 --tp 151.16 --risk-usd 25 --dry-run

# Testnet (default; BYBIT_ENV=live NOT set)
BYBIT_API_KEY=... BYBIT_API_SECRET=... \
python bybit-trade/trade.py place \
  --symbol SOLUSDT --side buy --qty 11.2 \
  --sl 145.97 --tp 151.16 --risk-usd 25

# Live — both flags required
BYBIT_ENV=live BYBIT_API_KEY=... BYBIT_API_SECRET=... \
python bybit-trade/trade.py place --live \
  --symbol SOLUSDT --side buy --qty 11.2 \
  --sl 145.97 --tp 151.16 --risk-usd 25

# Close (reduce-only market)
python bybit-trade/trade.py close --symbol SOLUSDT

# Inspect positions
python bybit-trade/trade.py positions [--symbol SOLUSDT]

Order structure

Every place call sends a Bybit v5 native bracket:

category=linear, orderType=Market, timeInForce=IOC
stopLoss=<sl>, takeProfit=<tp>, both with triggerBy=LastPrice
orderLinkId = "clive-{symbol}-{unix_ms}" for idempotency

Qty rounded to lotSizeFilter.qtyStep, SL/TP rounded to priceFilter.tickSize (fetched from /v5/market/instruments-info). Raw floats are never sent.

Guardrails (all hard-coded, no flags to disable)

Testnet unless --live AND BYBIT_ENV=live. If --live is set but BYBIT_ENV isn't live, exit 2.
risk-guard check --risk-usd N must exit 0. Its stderr is surfaced and the order is aborted on any non-zero exit.
Refuses to open a second position if one already exists for the symbol.
Qty below exchange minimum → exit with Bybit's message.
Bybit errors are surfaced verbatim. No fallbacks, no retries.

Exit codes

0 on success
2 on env/config veto (wrong env, missing keys, --live without BYBIT_ENV=live)
2 on risk-guard veto
1 on Bybit API error or invariant violation

Dry-run

--dry-run runs every step up through signing and prints the exact request it would have sent. Safe without testnet keys (uses placeholders if missing).

---name: bybit-tradedescription: Place a market entry with a native bracket stop-loss and take-profit on Bybit v5. Testnet by default. Use ONLY when the user explicitly asks to place/execute/open a trade and has already planned size with scalp-plan and confirmed risk with risk-guard. Dangerous — authenticated, touches real money on --live. Always confirm with the user before invoking.---# bybit-tradeAuthenticated bracket-order execution for Bybit v5 linear perps. Calls`risk-guard check` as a subprocess before every order and aborts on anynon-zero exit. Testnet by default — requires BOTH `--live` AND `BYBIT_ENV=live`to route to production.## When to useOnly when the user has:1. Planned size via `scalp-plan`2. Confirmed a `risk-guard` session exists3. Explicitly asked to place / execute / open the tradeAlways echo the plan and confirm with the user before invoking.## Required env vars- `BYBIT_API_KEY`- `BYBIT_API_SECRET`- `BYBIT_ENV=live` is REQUIRED in addition to `--live` for productionKeys are never accepted on the command line. If keys are missing the scriptexits with a clear error.## How to run```# Dry-run (signs the request but never POSTs)python bybit-trade/trade.py place \ --symbol SOLUSDT --side buy --qty 11.2 \ --sl 145.97 --tp 151.16 --risk-usd 25 --dry-run# Testnet (default; BYBIT_ENV=live NOT set)BYBIT_API_KEY=... BYBIT_API_SECRET=... \python bybit-trade/trade.py place \ --symbol SOLUSDT --side buy --qty 11.2 \ --sl 145.97 --tp 151.16 --risk-usd 25# Live — both flags requiredBYBIT_ENV=live BYBIT_API_KEY=... BYBIT_API_SECRET=... \python bybit-trade/trade.py place --live \ --symbol SOLUSDT --side buy --qty 11.2 \ --sl 145.97 --tp 151.16 --risk-usd 25# Close (reduce-only market)python bybit-trade/trade.py close --symbol SOLUSDT# Inspect positionspython bybit-trade/trade.py positions [--symbol SOLUSDT]```## Order structureEvery `place` call sends a Bybit v5 native bracket:- `category=linear`, `orderType=Market`, `timeInForce=IOC`- `stopLoss=<sl>`, `takeProfit=<tp>`, both with `triggerBy=LastPrice`- `orderLinkId = "clive-{symbol}-{unix_ms}"` for idempotencyQty rounded to `lotSizeFilter.qtyStep`, SL/TP rounded to `priceFilter.tickSize`(fetched from `/v5/market/instruments-info`). Raw floats are never sent.## Guardrails (all hard-coded, no flags to disable)1. Testnet unless `--live` AND `BYBIT_ENV=live`. If `--live` is set but `BYBIT_ENV` isn't `live`, exit 2.2. `risk-guard check --risk-usd N` must exit 0. Its stderr is surfaced and the order is aborted on any non-zero exit.3. Refuses to open a second position if one already exists for the symbol.4. Qty below exchange minimum → exit with Bybit's message.5. Bybit errors are surfaced verbatim. No fallbacks, no retries.## Exit codes- 0 on success- 2 on env/config veto (wrong env, missing keys, --live without BYBIT_ENV=live)- 2 on risk-guard veto- 1 on Bybit API error or invariant violation## Dry-run`--dry-run` runs every step up through signing and prints the exact requestit would have sent. Safe without testnet keys (uses placeholders if missing).

Frequently asked questions