moltrade

Operate the Moltrade trading bot (config, backtest, test-mode runs, Nostr signal broadcast, exchange adapters, strategy integration) in OpenClaw.

Security Scan

The skill's instructions, required binaries, and included reference files are coherent with a trading-bot operator: it asks you to run Python commands locally, uses exchange/Nostr credentials only where expected, and contains no unexpected install or credential demands.

Purpose & Capability

The name/description (operate Moltrade bot, backtests, Nostr, exchange adapters) matches the SKILL.md content: python/pip binaries, repo clone, pip install, backtest and run commands, and guidance for Nostr and exchange credentials. The included Binance support and Square-post docs are relevant to the stated exchange/social features.

Instruction Scope

The SKILL.md instructs the agent and user to run local Python commands, initialize configs, run backtests, and check Nostr/exchange config blocks. It explicitly warns agents not to request or handle private keys and to ask the human to run `python main.py --init` themselves. This is appropriate, but the SKILL.md does reference sensitive fields (e.g., `nsec`, API keys). The user should ensure the agent never asks the user to paste private keys into chat or store secrets in public files.

Install Mechanism

This is an instruction-only skill with no install spec and no code files executed by the platform. That minimizes write-to-disk risks. The documentation suggests cloning the official GitHub repo and using pip to install requirements — standard practice for a Python tool.

Credentials

The skill declares no required environment variables (the user provides keys for exchanges or Square/Nostr when needed). This is proportionate: trading and Nostr features legitimately need API keys/secret keys. The skill and bundled Binance docs do show examples that handle API_KEY/SECRET and advise limiting permissions (e.g., disable withdrawals) — follow those recommendations. Confirm the agent will not persist or exfiltrate those secrets.

Persistence & Privilege

always is false and the skill is user-invocable; model-invocation is allowed (platform default). The skill does not request persistent system-wide privileges or attempt to modify other skill configs in the provided documentation.

Assessment

This skill appears coherent for controlling the Moltrade bot, but trading and signal systems are intrinsically sensitive. Before installing: 1) Run everything in a safe/dev environment and use exchange testnet credentials first. 2) Create API keys with minimal permissions (spot trading only; disable withdrawals; IP whitelist). 3) Never paste your private wallet/Nostr `nsec` or secret keys into chat — prefer local config files or environment variables on your machine. 4) Verify the GitHub repo content locally (git clone) before running; inspect any scripts you execute. 5) When asked to run the bot, confirm the agent prompts you for explicit approval before switching from test to live mode. If you want higher assurance, review the upstream repo code (main.py, trader/*) to confirm there is no unexpected network exfiltration or hidden behavior.

Moltrade Bot Skill

Moltrade is a decentralized, automated trading assistant that lets you run quant strategies, share encrypted signals, and allow others to copy your trades—all securely via the Nostr network. Earn reputation and credits based on your trading performance.

YOUR 24/7 AI TRADER ! EARNING MONEY WHILE YOU'RE SLEEPING.

---

Advantages

Moltrade balances security, usability, and scalability. Key advantages include:

1. Client-side Key self-hosting,not cloud Custody,: All sensitive keys and credentials remain on the user's machine; the cloud relay never holds funds or private keys, minimizing custodial risk.No access to private keys or funds.
2. Encrypted, Targeted Communication: Signals are encrypted before publishing and only decryptable by intended subscribers, preserving strategy privacy and subscriber security.
3. Lightweight Cloud Re-encryption & Broadcast: The cloud acts as an efficient relay/re-broadcaster without storing private keys; re-encryption or forwarding techniques improve delivery reliability and reach.
4. One-Click Copy Trading (User Friendly): Provides an out-of-the-box copy-trading experience for non-expert users—set up in a few steps and execute signals locally.
5. OpenClaw Strategy Advisor: Integrates OpenClaw as an advisory tool for automated backtests and improvement suggestions; users decide whether to adopt recommended changes.
6. Cloud Can Be Decentralized Relayer Network: The lightweight relay architecture allows future migration to decentralized relay networks, reducing single points of failure and improving censorship resistance.
7. Unified Incentive (Credit) System: A transparent, verifiable Credit mechanism rewards all participants (signal providers, followers, relay nodes), aligning incentives across the ecosystem.

How It Works (Simplified Flow)

1) Run Your Bot  ──→  2) Generate & Encrypt  ──→  3) Relay  ──→  4) Copy & Execute  ──→  5) Verify & Earn

Install & Init

• If you are inside OpenClaw, you can install directly via ClawHub:

clawhub search moltrade
clawhub install moltrade

• OR Clone the repo and install Python deps locally:
  • 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:
  • Security Requirement: Always ask the human user to run python main.py --init themselves in a separate terminal. Do not ask for or handle their wallet private keys directly or save them to disk via agent scripts.
• 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.

Copy-trade Usage (live)

• Follower (mirrors leader, no strategy trading): python trader/main.py --config trader/config.json --strategy momentum --symbol HYPE --copytrade follower

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.

Binance Spot Support

Moltrade supports Binance Spot trading via binance-sdk-spot. Set trading.exchange to "binance" in your config and provide API credentials.

Related Skills (raw API calls, not tied to the bot runtime):

• binance/spot — Binance Spot REST API skill: market data, order management, account info. Requires API key + secret; supports testnet and mainnet.
• binance/square-post — Binance Square social platform skill: post trading insights/signals as text content via the Square OpenAPI. Requires a Square OpenAPI key.

Install Binance SDK

pip install binance-sdk-spot

Config Fields

Add a binance block alongside the existing trading block:

{
  "trading": {
    "exchange": "binance",
    "default_symbol": "BTCUSDT",
    "default_strategy": "momentum"
  },
  "binance": {
    "api_key": "your_mainnet_api_key",
    "api_secret": "your_mainnet_api_secret",
    "testnet_api_key": "your_testnet_api_key",
    "testnet_api_secret": "your_testnet_api_secret"
  }
}

Note: Binance testnet uses keys generated separately at https://testnet.binance.vision (GitHub login required). Mainnet keys do not work on the testnet.

Testnet (–-test)

When --test is passed the bot routes all requests to testnet.binance.vision and uses binance.testnet_api_key / testnet_api_secret. If testnet keys are absent it falls back to mainnet keys, which will cause auth errors against the testnet endpoint.

python trader/main.py --config config.json --test --strategy momentum --symbol BTCUSDT

Live Trading

python trader/main.py --config config.json --strategy momentum --symbol BTCUSDT

Backtest

python trader/backtest.py --config trader/config.example.json --strategy momentum --symbol BTCUSDT --interval 1h --limit 500

Supported Interface

BinanceClient (trader/binance_api.py) implements the same interface as HyperliquidClient:

Method	Description
get_candles(symbol, interval, limit)	K-line data as [ts, open, high, low, close, vol]
get_balance(asset)	Free balance for an asset (default "USDT")
get_positions()	Non-zero asset balances (spot has no margin positions)
get_open_orders()	All current open orders
place_order(symbol, is_buy, size, price, order_type)	LIMIT or MARKET order with auto lot-size / tick-size rounding
cancel_order(order_id, symbol)	Cancel by order ID
cancel_all_orders(symbol)	Cancel all orders (optionally for one symbol)
get_ticker_price(symbol)	Latest traded price

Uniswap V3 Support

Moltrade supports decentralized swaps on EVM chains using Uniswap V3 Router via web3. Set trading.exchange to "uniswap" in your config. Note that DEX swaps are atomic; there are no open limit orders or margin positions, and price charting requires an external oracle (currently returns empty or mock data locally).

Install Web3

pip install web3

Config Fields

Add a uniswap block alongside the existing trading block:

{
  "trading": {
    "exchange": "uniswap",
    "default_symbol": "WETH",
    "default_strategy": "momentum"
  },
  "uniswap": {
    "rpc_url": "https://eth-mainnet.g.alchemy.com/v2/...",
    "private_key": "your_wallet_private_key",
    "chain_id": 1,
    "router_address": "0xE592427A0AEce92De3Edee1F18E0157C05861564",
    "slippage_tolerance": 0.005,
    "default_token_in": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "default_token_out": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
  }
}

Polymarket Support

Moltrade supports prediction markets on Polymarket via the official py-clob-client. Set trading.exchange to "polymarket" in your config.

Install CLOB Client

pip install py-clob-client

Config Fields

Add a polymarket block alongside the existing trading block:

{
  "trading": {
    "exchange": "polymarket",
    "default_symbol": "TOKEN_ID_HERE",
    "default_strategy": "momentum"
  },
  "polymarket": {
    "api_key": "your_polymarket_api_key",
    "api_secret": "your_polymarket_api_secret",
    "api_passphrase": "your_polymarket_api_passphrase",
    "private_key": "your_wallet_private_key",
    "chain_id": 137
  }
}

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.