moltrade

Moltrade Bot Skill

Paths are repo-root relative. Keep actions deterministic and redact secrets.

Install & Init

• Clone the repo and install Python deps locally (code is required for strategies, nostr, and CLI):
  • git clone https://github.com/hetu-project/moltrade.git
  • cd moltrade/trader && pip install -r requirements.txt
• Initialize a fresh config with the built-in wizard (no trading):
  • Prefer the human user to run python main.py --init (prompts for relayer URL, wallet, nostr, copy-trade follower defaults, and bot registration), so you can approve prompts, handle the wallet private key entry yourself, and capture the relayer’s returned relayer_nostr_pubkey when registering the bot.
  • If you delegate to an agent, do so only if you trust it with the wallet key and ensure it completes the entire wizard—including the final bot registration step—so the relayer_nostr_pubkey gets written back to the config.
• For CI/agents, keep using the repo checkout; there is no separate pip package/CLI yet.

Update Config Safely

• Backup or show planned diff before edits.
• Change only requested fields (e.g., trading.exchange, trading.default_strategy, nostr.relays).
• Validate JSON; keep types intact. Remind user to provide real secrets themselves.

Run Backtest (local)

• Install deps: pip install -r trader/requirements.txt.
• Command: python trader/backtest.py --config trader/config.example.json --strategy <name> --symbol <symbol> --interval 1h --limit 500.
• Report PnL/win rate/trade count/drawdown if available. Use redacted config (no real keys).

Start Bot (test mode)

• Ensure config.json exists (run python main.py --init if not) and trading.exchange set (default hyperliquid).
• Command: python trader/main.py --config config.json --test --strategy <name> --symbol <symbol> --interval 300.
• Watch trading_bot.log; never switch to live without explicit user approval.

Run Bot (live)

• Only after validation on test mode; remove --test to hit mainnet.
• Command: python trader/main.py --config config.json --strategy <name> --symbol <symbol>.
• Double-check keys, risk limits, and symbol before starting; live mode will place real orders.

Broadcast Signals to Nostr

• Check nostr block: nsec, relayer_nostr_pubkey, relays, sid.
• SignalBroadcaster is wired in main.py. In test mode, verify send_trade_signal / send_execution_report run without errors.

Add Exchange Adapter

• Implement adapter in trader/exchanges/ matching HyperliquidClient interface (get_candles, get_balance, get_positions, place_order, etc.).
• Register in trader/exchanges/factory.py keyed by trading.exchange.
• Update config trading.exchange and rerun backtest/test-mode.

Integrate New Strategy

• Follow trader/strategies/INTEGRATION.md to subclass BaseStrategy and register in get_strategy.
• Add config under strategies.<name>; backtest, then test-mode before live.

Safety / Secrets

• Never print or commit private keys, mnemonics, nsec, or shared keys.
• Default to test mode; require explicit consent for live trading.