clawncher 0.1.7 → 0.1.8

package/README.md

@@ -505,6 +505,78 @@ clawncher deploy-verified --api-key YOUR_API_KEY --name "My Token" --symbol MYTK
 | `--no-vanity` | Disable vanity address |
 | `--json` | JSON output |
 
+## Hummingbot Market Making
+
+Operate a Hummingbot API server directly from the CLI. All commands are under `clawncher hummingbot` (alias: `clawncher hb`).
+
+Requires a running [Hummingbot API server](https://github.com/hummingbot/hummingbot-api).
+
+```bash
+# Connection health
+clawncher hb status
+
+# Portfolio across all exchanges
+clawncher hb portfolio
+
+# Connectors
+clawncher hb connector              # List connected exchanges
+clawncher hb connector --setup      # Add a new connector
+
+# Orders
+clawncher hb order place --connector binance --pair ETH-USDT --side BUY --amount 0.1 --type MARKET
+clawncher hb order leverage --connector binance_perpetual --pair ETH-USDT --leverage 10
+
+# Executors (grid, DCA, position, single-order)
+clawncher hb executor create --type grid_executor --connector binance --pair ETH-USDT ...
+clawncher hb executor list --connector binance --pair ETH-USDT
+clawncher hb executor stop --id exec_123
+clawncher hb executor logs --id exec_123
+clawncher hb executor positions
+clawncher hb executor types
+clawncher hb executor summary
+clawncher hb executor clear-position --connector binance --pair ETH-USDT
+
+# Market data
+clawncher hb market prices --connector binance --pair ETH-USDT
+clawncher hb market candles --connector binance --pair ETH-USDT --interval 1h
+clawncher hb market funding --connector binance_perpetual --pair ETH-USDT
+clawncher hb market orderbook --connector binance --pair ETH-USDT
+
+# Controllers
+clawncher hb controller list
+clawncher hb controller describe --id my_controller
+clawncher hb controller upsert --id my_controller --type market_making ...
+clawncher hb controller delete --id my_controller
+
+# Bots
+clawncher hb bot deploy --controllers mm_eth --connector binance
+clawncher hb bot list
+clawncher hb bot logs --id bot_123
+clawncher hb bot stop --id bot_123
+clawncher hb bot controllers --action start  # or stop
+
+# Gateway (DEX)
+clawncher hb gateway container    # Status, start, stop, logs
+clawncher hb gateway config       # Chains, networks, tokens, wallets
+clawncher hb gateway swap         # DEX swap quotes and execution
+clawncher hb gateway clmm         # Concentrated liquidity management
+
+# History and templates
+clawncher hb history
+clawncher hb templates
+
+# Multi-server
+clawncher hb servers
+```
+
+### Hummingbot Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `HUMMINGBOT_API_URL` | `http://localhost:8000` | Hummingbot API server URL |
+| `HUMMINGBOT_USERNAME` | `admin` | HTTP Basic Auth username |
+| `HUMMINGBOT_PASSWORD` | `admin` | HTTP Basic Auth password |
+
 ## Environment Variables
 
 - `CLAWNCHER_PRIVATE_KEY` - Private key for deployments