# Scalp Plan

> Compute position size, stop, take-profit, notional and margin for a scalp trade given equity, $-risk, entry, and stop/target percentages. Use whenever the user asks "how much size / size this trade / plan this scalp / what's my stop and target". Pure math, no network, no API keys.

- Skill: `daviddme/scalp-plan` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add daviddme/scalp-plan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/daviddme/scalp-plan/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: daviddme (https://skillmd.com/u/daviddme)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/daviddme/scalp-plan

---


# scalp-plan

Takes a planned entry, your dollar risk, and a stop/TP percentage and returns
the exact qty, stop price, TP price, notional, and required margin. Rounds to
tick / lot so numbers are actually placeable on Bybit.

## When to use
- "Size this for $25 risk"
- "What's my stop and target if I enter X at Y?"
- "Plan a long on SOLUSDT at $148"

## How to run
```
python scalp-plan/plan.py \
  --equity 500 --risk 25 \
  --side long --entry 148.20 \
  [--symbol SOLUSDT] \
  [--stop-pct 1.5] [--tp-pct 2.0] \
  [--tick 0.01] [--lot 0.001] \
  [--leverage 10] [--json]
```

Defaults: stop 1.5%, TP 2.0%, leverage 10x, tick 0.01, lot 0.001. Override
`--tick` and `--lot` per instrument (Bybit's `instruments-info` endpoint has
the exact values).

## Output
- `entry`, `stop`, `tp` (tick-rounded)
- `qty` (lot-rounded, floored — never exceeds your $-risk)
- `risk_actual` (may be slightly under `--risk` due to lot rounding)
- `notional`, `margin_required` (at given leverage)
- `r_r` (target / stop distance)
- warnings if qty rounds to zero, or if margin exceeds equity

## Exit codes
- 0 on success, 1 if warnings fired (qty zero, margin > equity, etc.)
- script exits with a message if stop equals entry after rounding

## Notes
- No network. Safe to run offline.
- Does not place any orders. Pairs with `bybit-trade` for execution.