hypertrader 0.1.6__tar.gz → 0.1.8__tar.gz

{hypertrader-0.1.6 → hypertrader-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypertrader
-Version: 0.1.6
+Version: 0.1.8
 Summary: Async Hyperliquid trading helper built on the async SDK.
 Author: darkerego
 License: MIT
@@ -31,7 +31,14 @@ Dynamic: summary
 
 # Hypertrader
 
-Async Hyperliquid trading helper built around the async SDK from `darkerego/hyperliquid-python-sdk-async`.
+Async Hyperliquid trading helper built around my async SDK: [hyperliquid-python-sdk-async](https://github.com/darkerego/hyperliquid-python-sdk-async).
+
+## Warning
+
+This is alpha software currently in development. Trade carefully, and if you encounter 
+any problems, please open an issue so that I can fic them.
+
+## About
 
 The canonical bot file in this repo is [`hypertrader.py`](/media/anon/development/anon/PycharmProjects/hypertrader/hypertrader.py). It provides five modes:
 
@@ -89,6 +96,9 @@ https://ta-lib.org/install/#linux
 
 ## Configuration
 
+
+##### [*] Account creation:
+
 1) Create a hyperliquid account with referral code `DARKEREGO` with this URL: 
 
     [https://app.hyperliquid.xyz/join/DARKEREGO](https://app.hyperliquid.xyz/join/DARKEREGO)
@@ -102,10 +112,12 @@ https://ta-lib.org/install/#linux
 ```text
 HYPERLIQUID_SECRET_KEY=...
 HYPERLIQUID_ACCOUNT_ADDRESS=...
+HYPERLIQUID_TESTNET_SECRET_KEY # optional, for testnet
 ```
 
 - `HYPERLIQUID_SECRET_KEY`: private key for the trading wallet or API wallet (the API key you just created)
 - `HYPERLIQUID_ACCOUNT_ADDRESS`: main account address used for the account state
+- `HYPERLIQUID_TESTNET_SECRET_KEY`: optional testnet API key
 
 Do not commit real credentials.
 
@@ -135,7 +147,13 @@ Enter, let TP level 1 fill, then cancel the rest of the ladder and trail the rem
 python3 hypertrader.py enter BTC long --size 0.1 --take-profit-pct 0.01 --trailing-tp
 ```
 
-Watch an existing position and attach management:
+Watch all perpetual markets for new and currently opened positions and attach management.
+
+```bash
+python3 hypertrader.py watch BTC --take-profit-pct 0.01 --manage-existing
+```
+
+Watch an existing position on a specific market and attach management:
 
 ```bash
 python3 hypertrader.py watch BTC --take-profit-pct 0.01 --manage-existing
@@ -147,13 +165,26 @@ Watch a position and switch from the TP ladder to a trailing TP after TP level 1
 python3 hypertrader.py watch BTC --take-profit-pct 0.01 --manage-existing --trailing-tp
 ```
 
-Run local trailing management:
+Run local trailing management for all perpetual markets:
+
+```bash
+python3 hypertrader.py trailing --trail-pct 0.01
+```
+
+
+Run local trailing management for a specific market:
 
 ```bash
 python3 hypertrader.py trailing BTC --trail-pct 0.01
 ```
 
-Dry-run auto mode across short intervals:
+Dry-run auto mode across the top 15 markets by volume concurrently, open positions with 10% of accounts' collateral:
+
+```bash
+python3 hypertrader.py auto --intervals "1m 3m 5m" --top-markets 15 --size-pct 10 --dry-run
+```
+
+Dry-run auto mode across short intervals on a specific market only with a static position size:
 
 ```bash
 python3 hypertrader.py auto SOL --intervals "1m 3m 5m" --size 10 --dry-run
@@ -247,7 +278,15 @@ Key options:
 
 ### `auto`
 
-Scans one coin or the top perp markets using TA-Lib signals from:
+`auto` now supports selectable strategies:
+
+- `default`: the existing MACD/SAR/ADX/Bollinger auto trader and the implicit default when `--strategy` is omitted
+- `orderflow_pullback`: order-flow-confirmed trend pullback scalp strategy, also available as `of_pullback` and `orderflow`
+- `reversal`: a closed-candle trend-exhaustion, structure-break, and retest strategy
+
+The strategy selection changes the signal engine only. Shared sizing, risk controls, modify-order entry, market-fallback cleanup, hidden-order behavior, and bracket management still run through the same common auto execution path.
+
+The default strategy scans one coin or the top perp markets using TA-Lib signals from:
 
 - MACD
 - Parabolic SAR
@@ -262,6 +301,8 @@ python3 hypertrader.py auto [COIN] (--size SIZE | --size-pct SIZE_PCT) [options]
 
 Key options:
 
+- `--strategy {default,reversal}`
+- `--strategy {default,orderflow_pullback,reversal}` with aliases `of_pullback` and `orderflow`
 - `--size` or `--size-pct`
 - `--top-markets`
 - `--intervals`
@@ -288,7 +329,6 @@ Key options:
 - `--take-profit-levels`
 - `--trailing-tp`
 - `--trailing-tp-trigger-level`
-- `--trailing-tp-remaining-levels`
 - `--trailing-tp-profit-pct`
 - `--entry-retries`
 - `--entry-repost-interval`
@@ -316,13 +356,97 @@ Key options:
 - `--session-max-loss`
 - `--session-giveback-pct`
 - `--risk-session-log`
-- `--ws-candles`
+- `--disable-ws-candles`
 - `--hide-orders` or `-ho`
 - `--testnet`
 - `--no-websocket`
 
 `auto` derives TP from Bollinger Bands unless `--take-profit-pct` overrides it. If TP is set and SL is omitted, SL defaults to half TP. Executions route through the same bracket-entry path used by `enter`.
 
+Reversal strategy notes:
+
+- All confirmations use closed candles only.
+- SAR alone never opens a trade.
+- A trade requires: prior trend, exhaustion, confirmed Williams-fractal structure break, then a confirmed retest.
+- Default reversal intervals are `--trend-interval 1h` and `--entry-interval 15m`.
+- Reversal entries build explicit entry, stop, and multi-target plans before handing execution to the shared auto engine.
+- Hidden-order mode still applies: `--hide-orders` keeps reversal TP/SL targets local until trigger conditions are met.
+
+Important reversal-specific options:
+
+- `--trend-interval`: higher timeframe used for prior-trend classification
+- `--entry-interval`: lower timeframe used for structure-break and retest confirmation
+- `--reversal-min-adx`: minimum higher-timeframe ADX required before a reversal setup is considered
+- `--reversal-exhaustion-score`: minimum exhaustion confirmations required before structure-break tracking starts
+- `--reversal-retest-timeout`: number of entry candles allowed for the retest to confirm before the setup expires
+- `--reversal-stop-atr-buffer`: ATR buffer added beyond the invalidation point when computing the stop
+- `--reversal-max-stop-atr`: caps the stop width in ATR terms
+- `--reversal-min-rr`: minimum reward-to-risk ratio required for a valid execution plan
+- `--reversal-tp1-r`, `--reversal-tp2-r`, `--reversal-tp3-r`: target distances in multiples of initial risk
+- `--reversal-tp1-pct`, `--reversal-tp2-pct`, `--reversal-runner-pct`: allocation percentages for the three reversal exits; they must sum to `100`
+- `--reversal-exit-on-sar-flip` / `--no-reversal-exit-on-sar-flip`: enable or disable SAR-flip managed exits after entry
+- `--reversal-min-ema50-slope`: minimum absolute higher-timeframe EMA slope required to qualify the prior trend
+
+Example single-coin reversal scan:
+
+```bash
+python3 hypertrader.py auto --strategy reversal \
+  BTC \
+  --size-pct 5 \
+  --trend-interval 1h \
+  --entry-interval 15m \
+  --reversal-min-adx 18 \
+  --reversal-exhaustion-score 2 \
+  --reversal-min-rr 1.8 \
+  --reversal-exit-on-sar-flip
+```
+
+Order-flow pullback strategy notes:
+
+- Uses closed `1m`/`5m` candles for regime context and live `l2Book` plus `trades` websocket feeds for entry confirmation.
+- Indicators classify context only; executed trade flow, weighted book imbalance, and microprice authorize entries.
+- Entries still route through the shared modify-order post-only entry path.
+- Hidden-order mode still applies: `--hide-orders` keeps TP/SL targets local instead of placing exchange-visible brackets.
+
+Important order-flow options:
+
+- `--of-max-active-books`: maximum promoted markets with live book/trade monitoring
+- `--of-max-spread-bps` and `--of-max-spread-ratio`: live spread gates
+- `--of-min-depth-ratio`: executable depth gate versus intended order notional
+- `--of-warmup-seconds`: warm-up period after promotion before entries are allowed
+- `--of-min-edge-cost-multiple`: expected-move versus estimated round-trip-cost gate
+- `--of-pullback-min` and `--of-pullback-max`: retracement zone bounds
+- `--of-book-imbalance-min`, `--of-micro-bias-min`, `--of-trade-imbalance-2s-min`, and `--of-trade-imbalance-10s-min`: mandatory confirmation thresholds
+- `--of-entry-timeout-seconds` and `--of-max-chase-ticks`: entry aggressiveness controls layered onto the shared entry helper
+
+Example order-flow scan:
+
+```bash
+python3 hypertrader.py auto \
+  --strategy orderflow_pullback \
+  --top-markets 30 \
+  --size-pct 5 \
+  --scan-interval 1 \
+  --of-max-active-books 8 \
+  --of-max-spread-bps 3 \
+  --of-min-depth-ratio 10 \
+  --of-entry-timeout-seconds 2 \
+  --of-max-chase-ticks 2
+```
+
+Example top-market reversal scan:
+
+```bash
+python3 hypertrader.py auto --strategy reversal \
+  --top-markets 30 \
+  --size-pct 5 \
+  --trend-interval 1h \
+  --entry-interval 15m \
+  --scan-interval 30 \
+  --loop-after-trade \
+  --max-coin-trades-per-session 3
+```
+
 Additional `auto` parameter notes:
 
 - `--max-concurrent-scans`: limits how many markets are scanned in parallel in each auto loop.

{hypertrader-0.1.6 → hypertrader-0.1.8}/README.md

@@ -1,6 +1,13 @@
 # Hypertrader
 
-Async Hyperliquid trading helper built around the async SDK from `darkerego/hyperliquid-python-sdk-async`.
+Async Hyperliquid trading helper built around my async SDK: [hyperliquid-python-sdk-async](https://github.com/darkerego/hyperliquid-python-sdk-async).
+
+## Warning
+
+This is alpha software currently in development. Trade carefully, and if you encounter 
+any problems, please open an issue so that I can fic them.
+
+## About
 
 The canonical bot file in this repo is [`hypertrader.py`](/media/anon/development/anon/PycharmProjects/hypertrader/hypertrader.py). It provides five modes:
 
@@ -58,6 +65,9 @@ https://ta-lib.org/install/#linux
 
 ## Configuration
 
+
+##### [*] Account creation:
+
 1) Create a hyperliquid account with referral code `DARKEREGO` with this URL: 
 
     [https://app.hyperliquid.xyz/join/DARKEREGO](https://app.hyperliquid.xyz/join/DARKEREGO)
@@ -71,10 +81,12 @@ https://ta-lib.org/install/#linux
 ```text
 HYPERLIQUID_SECRET_KEY=...
 HYPERLIQUID_ACCOUNT_ADDRESS=...
+HYPERLIQUID_TESTNET_SECRET_KEY # optional, for testnet
 ```
 
 - `HYPERLIQUID_SECRET_KEY`: private key for the trading wallet or API wallet (the API key you just created)
 - `HYPERLIQUID_ACCOUNT_ADDRESS`: main account address used for the account state
+- `HYPERLIQUID_TESTNET_SECRET_KEY`: optional testnet API key
 
 Do not commit real credentials.
 
@@ -104,7 +116,13 @@ Enter, let TP level 1 fill, then cancel the rest of the ladder and trail the rem
 python3 hypertrader.py enter BTC long --size 0.1 --take-profit-pct 0.01 --trailing-tp
 ```
 
-Watch an existing position and attach management:
+Watch all perpetual markets for new and currently opened positions and attach management.
+
+```bash
+python3 hypertrader.py watch BTC --take-profit-pct 0.01 --manage-existing
+```
+
+Watch an existing position on a specific market and attach management:
 
 ```bash
 python3 hypertrader.py watch BTC --take-profit-pct 0.01 --manage-existing
@@ -116,13 +134,26 @@ Watch a position and switch from the TP ladder to a trailing TP after TP level 1
 python3 hypertrader.py watch BTC --take-profit-pct 0.01 --manage-existing --trailing-tp
 ```
 
-Run local trailing management:
+Run local trailing management for all perpetual markets:
+
+```bash
+python3 hypertrader.py trailing --trail-pct 0.01
+```
+
+
+Run local trailing management for a specific market:
 
 ```bash
 python3 hypertrader.py trailing BTC --trail-pct 0.01
 ```
 
-Dry-run auto mode across short intervals:
+Dry-run auto mode across the top 15 markets by volume concurrently, open positions with 10% of accounts' collateral:
+
+```bash
+python3 hypertrader.py auto --intervals "1m 3m 5m" --top-markets 15 --size-pct 10 --dry-run
+```
+
+Dry-run auto mode across short intervals on a specific market only with a static position size:
 
 ```bash
 python3 hypertrader.py auto SOL --intervals "1m 3m 5m" --size 10 --dry-run
@@ -216,7 +247,15 @@ Key options:
 
 ### `auto`
 
-Scans one coin or the top perp markets using TA-Lib signals from:
+`auto` now supports selectable strategies:
+
+- `default`: the existing MACD/SAR/ADX/Bollinger auto trader and the implicit default when `--strategy` is omitted
+- `orderflow_pullback`: order-flow-confirmed trend pullback scalp strategy, also available as `of_pullback` and `orderflow`
+- `reversal`: a closed-candle trend-exhaustion, structure-break, and retest strategy
+
+The strategy selection changes the signal engine only. Shared sizing, risk controls, modify-order entry, market-fallback cleanup, hidden-order behavior, and bracket management still run through the same common auto execution path.
+
+The default strategy scans one coin or the top perp markets using TA-Lib signals from:
 
 - MACD
 - Parabolic SAR
@@ -231,6 +270,8 @@ python3 hypertrader.py auto [COIN] (--size SIZE | --size-pct SIZE_PCT) [options]
 
 Key options:
 
+- `--strategy {default,reversal}`
+- `--strategy {default,orderflow_pullback,reversal}` with aliases `of_pullback` and `orderflow`
 - `--size` or `--size-pct`
 - `--top-markets`
 - `--intervals`
@@ -257,7 +298,6 @@ Key options:
 - `--take-profit-levels`
 - `--trailing-tp`
 - `--trailing-tp-trigger-level`
-- `--trailing-tp-remaining-levels`
 - `--trailing-tp-profit-pct`
 - `--entry-retries`
 - `--entry-repost-interval`
@@ -285,13 +325,97 @@ Key options:
 - `--session-max-loss`
 - `--session-giveback-pct`
 - `--risk-session-log`
-- `--ws-candles`
+- `--disable-ws-candles`
 - `--hide-orders` or `-ho`
 - `--testnet`
 - `--no-websocket`
 
 `auto` derives TP from Bollinger Bands unless `--take-profit-pct` overrides it. If TP is set and SL is omitted, SL defaults to half TP. Executions route through the same bracket-entry path used by `enter`.
 
+Reversal strategy notes:
+
+- All confirmations use closed candles only.
+- SAR alone never opens a trade.
+- A trade requires: prior trend, exhaustion, confirmed Williams-fractal structure break, then a confirmed retest.
+- Default reversal intervals are `--trend-interval 1h` and `--entry-interval 15m`.
+- Reversal entries build explicit entry, stop, and multi-target plans before handing execution to the shared auto engine.
+- Hidden-order mode still applies: `--hide-orders` keeps reversal TP/SL targets local until trigger conditions are met.
+
+Important reversal-specific options:
+
+- `--trend-interval`: higher timeframe used for prior-trend classification
+- `--entry-interval`: lower timeframe used for structure-break and retest confirmation
+- `--reversal-min-adx`: minimum higher-timeframe ADX required before a reversal setup is considered
+- `--reversal-exhaustion-score`: minimum exhaustion confirmations required before structure-break tracking starts
+- `--reversal-retest-timeout`: number of entry candles allowed for the retest to confirm before the setup expires
+- `--reversal-stop-atr-buffer`: ATR buffer added beyond the invalidation point when computing the stop
+- `--reversal-max-stop-atr`: caps the stop width in ATR terms
+- `--reversal-min-rr`: minimum reward-to-risk ratio required for a valid execution plan
+- `--reversal-tp1-r`, `--reversal-tp2-r`, `--reversal-tp3-r`: target distances in multiples of initial risk
+- `--reversal-tp1-pct`, `--reversal-tp2-pct`, `--reversal-runner-pct`: allocation percentages for the three reversal exits; they must sum to `100`
+- `--reversal-exit-on-sar-flip` / `--no-reversal-exit-on-sar-flip`: enable or disable SAR-flip managed exits after entry
+- `--reversal-min-ema50-slope`: minimum absolute higher-timeframe EMA slope required to qualify the prior trend
+
+Example single-coin reversal scan:
+
+```bash
+python3 hypertrader.py auto --strategy reversal \
+  BTC \
+  --size-pct 5 \
+  --trend-interval 1h \
+  --entry-interval 15m \
+  --reversal-min-adx 18 \
+  --reversal-exhaustion-score 2 \
+  --reversal-min-rr 1.8 \
+  --reversal-exit-on-sar-flip
+```
+
+Order-flow pullback strategy notes:
+
+- Uses closed `1m`/`5m` candles for regime context and live `l2Book` plus `trades` websocket feeds for entry confirmation.
+- Indicators classify context only; executed trade flow, weighted book imbalance, and microprice authorize entries.
+- Entries still route through the shared modify-order post-only entry path.
+- Hidden-order mode still applies: `--hide-orders` keeps TP/SL targets local instead of placing exchange-visible brackets.
+
+Important order-flow options:
+
+- `--of-max-active-books`: maximum promoted markets with live book/trade monitoring
+- `--of-max-spread-bps` and `--of-max-spread-ratio`: live spread gates
+- `--of-min-depth-ratio`: executable depth gate versus intended order notional
+- `--of-warmup-seconds`: warm-up period after promotion before entries are allowed
+- `--of-min-edge-cost-multiple`: expected-move versus estimated round-trip-cost gate
+- `--of-pullback-min` and `--of-pullback-max`: retracement zone bounds
+- `--of-book-imbalance-min`, `--of-micro-bias-min`, `--of-trade-imbalance-2s-min`, and `--of-trade-imbalance-10s-min`: mandatory confirmation thresholds
+- `--of-entry-timeout-seconds` and `--of-max-chase-ticks`: entry aggressiveness controls layered onto the shared entry helper
+
+Example order-flow scan:
+
+```bash
+python3 hypertrader.py auto \
+  --strategy orderflow_pullback \
+  --top-markets 30 \
+  --size-pct 5 \
+  --scan-interval 1 \
+  --of-max-active-books 8 \
+  --of-max-spread-bps 3 \
+  --of-min-depth-ratio 10 \
+  --of-entry-timeout-seconds 2 \
+  --of-max-chase-ticks 2
+```
+
+Example top-market reversal scan:
+
+```bash
+python3 hypertrader.py auto --strategy reversal \
+  --top-markets 30 \
+  --size-pct 5 \
+  --trend-interval 1h \
+  --entry-interval 15m \
+  --scan-interval 30 \
+  --loop-after-trade \
+  --max-coin-trades-per-session 3
+```
+
 Additional `auto` parameter notes:
 
 - `--max-concurrent-scans`: limits how many markets are scanned in parallel in each auto loop.

{hypertrader-0.1.6 → hypertrader-0.1.8}/hypertrader.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypertrader
-Version: 0.1.6
+Version: 0.1.8
 Summary: Async Hyperliquid trading helper built on the async SDK.
 Author: darkerego
 License: MIT
@@ -31,7 +31,14 @@ Dynamic: summary
 
 # Hypertrader
 
-Async Hyperliquid trading helper built around the async SDK from `darkerego/hyperliquid-python-sdk-async`.
+Async Hyperliquid trading helper built around my async SDK: [hyperliquid-python-sdk-async](https://github.com/darkerego/hyperliquid-python-sdk-async).
+
+## Warning
+
+This is alpha software currently in development. Trade carefully, and if you encounter 
+any problems, please open an issue so that I can fic them.
+
+## About
 
 The canonical bot file in this repo is [`hypertrader.py`](/media/anon/development/anon/PycharmProjects/hypertrader/hypertrader.py). It provides five modes:
 
@@ -89,6 +96,9 @@ https://ta-lib.org/install/#linux
 
 ## Configuration
 
+
+##### [*] Account creation:
+
 1) Create a hyperliquid account with referral code `DARKEREGO` with this URL: 
 
     [https://app.hyperliquid.xyz/join/DARKEREGO](https://app.hyperliquid.xyz/join/DARKEREGO)
@@ -102,10 +112,12 @@ https://ta-lib.org/install/#linux
 ```text
 HYPERLIQUID_SECRET_KEY=...
 HYPERLIQUID_ACCOUNT_ADDRESS=...
+HYPERLIQUID_TESTNET_SECRET_KEY # optional, for testnet
 ```
 
 - `HYPERLIQUID_SECRET_KEY`: private key for the trading wallet or API wallet (the API key you just created)
 - `HYPERLIQUID_ACCOUNT_ADDRESS`: main account address used for the account state
+- `HYPERLIQUID_TESTNET_SECRET_KEY`: optional testnet API key
 
 Do not commit real credentials.
 
@@ -135,7 +147,13 @@ Enter, let TP level 1 fill, then cancel the rest of the ladder and trail the rem
 python3 hypertrader.py enter BTC long --size 0.1 --take-profit-pct 0.01 --trailing-tp
 ```
 
-Watch an existing position and attach management:
+Watch all perpetual markets for new and currently opened positions and attach management.
+
+```bash
+python3 hypertrader.py watch BTC --take-profit-pct 0.01 --manage-existing
+```
+
+Watch an existing position on a specific market and attach management:
 
 ```bash
 python3 hypertrader.py watch BTC --take-profit-pct 0.01 --manage-existing
@@ -147,13 +165,26 @@ Watch a position and switch from the TP ladder to a trailing TP after TP level 1
 python3 hypertrader.py watch BTC --take-profit-pct 0.01 --manage-existing --trailing-tp
 ```
 
-Run local trailing management:
+Run local trailing management for all perpetual markets:
+
+```bash
+python3 hypertrader.py trailing --trail-pct 0.01
+```
+
+
+Run local trailing management for a specific market:
 
 ```bash
 python3 hypertrader.py trailing BTC --trail-pct 0.01
 ```
 
-Dry-run auto mode across short intervals:
+Dry-run auto mode across the top 15 markets by volume concurrently, open positions with 10% of accounts' collateral:
+
+```bash
+python3 hypertrader.py auto --intervals "1m 3m 5m" --top-markets 15 --size-pct 10 --dry-run
+```
+
+Dry-run auto mode across short intervals on a specific market only with a static position size:
 
 ```bash
 python3 hypertrader.py auto SOL --intervals "1m 3m 5m" --size 10 --dry-run
@@ -247,7 +278,15 @@ Key options:
 
 ### `auto`
 
-Scans one coin or the top perp markets using TA-Lib signals from:
+`auto` now supports selectable strategies:
+
+- `default`: the existing MACD/SAR/ADX/Bollinger auto trader and the implicit default when `--strategy` is omitted
+- `orderflow_pullback`: order-flow-confirmed trend pullback scalp strategy, also available as `of_pullback` and `orderflow`
+- `reversal`: a closed-candle trend-exhaustion, structure-break, and retest strategy
+
+The strategy selection changes the signal engine only. Shared sizing, risk controls, modify-order entry, market-fallback cleanup, hidden-order behavior, and bracket management still run through the same common auto execution path.
+
+The default strategy scans one coin or the top perp markets using TA-Lib signals from:
 
 - MACD
 - Parabolic SAR
@@ -262,6 +301,8 @@ python3 hypertrader.py auto [COIN] (--size SIZE | --size-pct SIZE_PCT) [options]
 
 Key options:
 
+- `--strategy {default,reversal}`
+- `--strategy {default,orderflow_pullback,reversal}` with aliases `of_pullback` and `orderflow`
 - `--size` or `--size-pct`
 - `--top-markets`
 - `--intervals`
@@ -288,7 +329,6 @@ Key options:
 - `--take-profit-levels`
 - `--trailing-tp`
 - `--trailing-tp-trigger-level`
-- `--trailing-tp-remaining-levels`
 - `--trailing-tp-profit-pct`
 - `--entry-retries`
 - `--entry-repost-interval`
@@ -316,13 +356,97 @@ Key options:
 - `--session-max-loss`
 - `--session-giveback-pct`
 - `--risk-session-log`
-- `--ws-candles`
+- `--disable-ws-candles`
 - `--hide-orders` or `-ho`
 - `--testnet`
 - `--no-websocket`
 
 `auto` derives TP from Bollinger Bands unless `--take-profit-pct` overrides it. If TP is set and SL is omitted, SL defaults to half TP. Executions route through the same bracket-entry path used by `enter`.
 
+Reversal strategy notes:
+
+- All confirmations use closed candles only.
+- SAR alone never opens a trade.
+- A trade requires: prior trend, exhaustion, confirmed Williams-fractal structure break, then a confirmed retest.
+- Default reversal intervals are `--trend-interval 1h` and `--entry-interval 15m`.
+- Reversal entries build explicit entry, stop, and multi-target plans before handing execution to the shared auto engine.
+- Hidden-order mode still applies: `--hide-orders` keeps reversal TP/SL targets local until trigger conditions are met.
+
+Important reversal-specific options:
+
+- `--trend-interval`: higher timeframe used for prior-trend classification
+- `--entry-interval`: lower timeframe used for structure-break and retest confirmation
+- `--reversal-min-adx`: minimum higher-timeframe ADX required before a reversal setup is considered
+- `--reversal-exhaustion-score`: minimum exhaustion confirmations required before structure-break tracking starts
+- `--reversal-retest-timeout`: number of entry candles allowed for the retest to confirm before the setup expires
+- `--reversal-stop-atr-buffer`: ATR buffer added beyond the invalidation point when computing the stop
+- `--reversal-max-stop-atr`: caps the stop width in ATR terms
+- `--reversal-min-rr`: minimum reward-to-risk ratio required for a valid execution plan
+- `--reversal-tp1-r`, `--reversal-tp2-r`, `--reversal-tp3-r`: target distances in multiples of initial risk
+- `--reversal-tp1-pct`, `--reversal-tp2-pct`, `--reversal-runner-pct`: allocation percentages for the three reversal exits; they must sum to `100`
+- `--reversal-exit-on-sar-flip` / `--no-reversal-exit-on-sar-flip`: enable or disable SAR-flip managed exits after entry
+- `--reversal-min-ema50-slope`: minimum absolute higher-timeframe EMA slope required to qualify the prior trend
+
+Example single-coin reversal scan:
+
+```bash
+python3 hypertrader.py auto --strategy reversal \
+  BTC \
+  --size-pct 5 \
+  --trend-interval 1h \
+  --entry-interval 15m \
+  --reversal-min-adx 18 \
+  --reversal-exhaustion-score 2 \
+  --reversal-min-rr 1.8 \
+  --reversal-exit-on-sar-flip
+```
+
+Order-flow pullback strategy notes:
+
+- Uses closed `1m`/`5m` candles for regime context and live `l2Book` plus `trades` websocket feeds for entry confirmation.
+- Indicators classify context only; executed trade flow, weighted book imbalance, and microprice authorize entries.
+- Entries still route through the shared modify-order post-only entry path.
+- Hidden-order mode still applies: `--hide-orders` keeps TP/SL targets local instead of placing exchange-visible brackets.
+
+Important order-flow options:
+
+- `--of-max-active-books`: maximum promoted markets with live book/trade monitoring
+- `--of-max-spread-bps` and `--of-max-spread-ratio`: live spread gates
+- `--of-min-depth-ratio`: executable depth gate versus intended order notional
+- `--of-warmup-seconds`: warm-up period after promotion before entries are allowed
+- `--of-min-edge-cost-multiple`: expected-move versus estimated round-trip-cost gate
+- `--of-pullback-min` and `--of-pullback-max`: retracement zone bounds
+- `--of-book-imbalance-min`, `--of-micro-bias-min`, `--of-trade-imbalance-2s-min`, and `--of-trade-imbalance-10s-min`: mandatory confirmation thresholds
+- `--of-entry-timeout-seconds` and `--of-max-chase-ticks`: entry aggressiveness controls layered onto the shared entry helper
+
+Example order-flow scan:
+
+```bash
+python3 hypertrader.py auto \
+  --strategy orderflow_pullback \
+  --top-markets 30 \
+  --size-pct 5 \
+  --scan-interval 1 \
+  --of-max-active-books 8 \
+  --of-max-spread-bps 3 \
+  --of-min-depth-ratio 10 \
+  --of-entry-timeout-seconds 2 \
+  --of-max-chase-ticks 2
+```
+
+Example top-market reversal scan:
+
+```bash
+python3 hypertrader.py auto --strategy reversal \
+  --top-markets 30 \
+  --size-pct 5 \
+  --trend-interval 1h \
+  --entry-interval 15m \
+  --scan-interval 30 \
+  --loop-after-trade \
+  --max-coin-trades-per-session 3
+```
+
 Additional `auto` parameter notes:
 
 - `--max-concurrent-scans`: limits how many markets are scanned in parallel in each auto loop.

hypertrader-0.1.8/hypertrader.egg-info/SOURCES.txt

@@ -0,0 +1,35 @@
+README.md
+hypertrader.py
+setup.py
+hypertrader.egg-info/PKG-INFO
+hypertrader.egg-info/SOURCES.txt
+hypertrader.egg-info/dependency_links.txt
+hypertrader.egg-info/entry_points.txt
+hypertrader.egg-info/requires.txt
+hypertrader.egg-info/top_level.txt
+modes/auto_trader.py
+modes/market_maker.py
+modes/position_management.py
+modes/position_watcher.py
+modes/trailing_stop.py
+strategies/__init__.py
+strategies/base.py
+strategies/default.py
+strategies/orderflow_metrics.py
+strategies/orderflow_models.py
+strategies/orderflow_pullback.py
+strategies/registry.py
+strategies/reversal.py
+tests/test_async_hyperliquid.py
+tests/test_auto_strategy_registry.py
+tests/test_auto_trader_logging.py
+tests/test_market_ids.py
+tests/test_orderflow_metrics.py
+tests/test_orderflow_pullback_lifecycle.py
+tests/test_reversal_strategy.py
+tests/test_trailing_stop.py
+utils/constants.py
+utils/helpers.py
+utils/style.py
+utils/timer.py
+utils/worker.py