Merge remote-tracking branch 'origin/main' into main

README.md

@@ -28,6 +28,12 @@ pipx install coinhunter
 coinhunter --help
 ```
 
+You can also use the shorter `coin` alias:
+
+```bash
+coin --help
+```
+
 Check the installed version:
 
 ```bash
@@ -68,25 +74,41 @@ Override the default home directory with `COINHUNTER_HOME`.
 
 By default, CoinHunter prints human-friendly TUI tables. Add `--agent` to any command to get JSON output (or compact pipe-delimited tables for large datasets).
 
+Add `--doc` to any command to see its output schema and field descriptions (great for AI agents):
+
 ```bash
-# Account
+coin buy --doc
+coin market klines --doc
+```
+
+### Examples
+
+```bash
+# Account (aliases: a, acc)
 coinhunter account overview
 coinhunter account overview --agent
-coinhunter account balances
-coinhunter account positions
+coin a ov
+coin acc bal
+coin a pos
 
-# Market
+# Market (aliases: m)
 coinhunter market tickers BTCUSDT ETH/USDT sol-usdt
 coinhunter market klines BTCUSDT ETHUSDT --interval 1h --limit 50
+coin m tk BTCUSDT ETHUSDT
+coin m k BTCUSDT -i 1h -l 50
 
-# Trade
-coinhunter trade buy BTCUSDT --quote 100 --dry-run
-coinhunter trade sell BTCUSDT --qty 0.01 --type limit --price 90000
+# Trade (buy / sell are now top-level commands)
+coinhunter buy BTCUSDT --quote 100 --dry-run
+coinhunter sell BTCUSDT --qty 0.01 --type limit --price 90000
+coin b BTCUSDT -Q 100 -d
+coin s BTCUSDT -q 0.01 -t limit -p 90000
 
-# Opportunities
+# Opportunities (aliases: opp, o)
 coinhunter opportunity portfolio
 coinhunter opportunity scan
 coinhunter opportunity scan --symbols BTCUSDT ETHUSDT SOLUSDT
+coin opp pf
+coin o scan -s BTCUSDT ETHUSDT
 
 # Audit log
 coinhunter catlog
@@ -95,6 +117,7 @@ coinhunter catlog -n 10 -o 10
 
 # Self-upgrade
 coinhunter upgrade
+coin upgrade
 
 # Shell completion (manual)
 coinhunter completion zsh  > ~/.zsh/completions/_coinhunter