hypertrader 0.1.6__tar.gz → 0.1.7__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypertrader
-Version: 0.1.6
+Version: 0.1.7
 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,14 @@ 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
+- `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 +300,7 @@ python3 hypertrader.py auto [COIN] (--size SIZE | --size-pct SIZE_PCT) [options]
 
 Key options:
 
+- `--strategy {default,reversal}`
 - `--size` or `--size-pct`
 - `--top-markets`
 - `--intervals`
@@ -288,7 +327,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 +354,64 @@ 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
+```
+
+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.7}/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,14 @@ 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
+- `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 +269,7 @@ python3 hypertrader.py auto [COIN] (--size SIZE | --size-pct SIZE_PCT) [options]
 
 Key options:
 
+- `--strategy {default,reversal}`
 - `--size` or `--size-pct`
 - `--top-markets`
 - `--intervals`
@@ -257,7 +296,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 +323,64 @@ 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
+```
+
+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.7}/hypertrader.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypertrader
-Version: 0.1.6
+Version: 0.1.7
 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,14 @@ 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
+- `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 +300,7 @@ python3 hypertrader.py auto [COIN] (--size SIZE | --size-pct SIZE_PCT) [options]
 
 Key options:
 
+- `--strategy {default,reversal}`
 - `--size` or `--size-pct`
 - `--top-markets`
 - `--intervals`
@@ -288,7 +327,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 +354,64 @@ 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
+```
+
+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.7}/hypertrader.egg-info/SOURCES.txt

@@ -12,6 +12,14 @@ 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/registry.py
+strategies/reversal.py
+tests/test_async_hyperliquid.py
+tests/test_auto_strategy_registry.py
+tests/test_reversal_strategy.py
 utils/constants.py
 utils/helpers.py
 utils/style.py

{hypertrader-0.1.6 → hypertrader-0.1.7}/hypertrader.egg-info/top_level.txt

@@ -1,3 +1,4 @@
 hypertrader
 modes
+strategies
 utils