tradr

Full onchain trade execution engine. You bring the signal, tradr handles everything else.

Input: Contract address + score Output: Buy → monitor → exit (mechanical)

No signal generation. No opinion on what to buy. All opinion on how to manage it once you're in.

Quick Start

# 1. Install
./scripts/setup.sh

# 2. Edit config
vi config.json    # Add wallet addresses, tune scoring/modes

# 3. Start the exit manager daemon
sudo systemctl start tradr-exit-manager

# 4. Feed a trade
python3 scripts/tradr-enter.py <CA> --score <N> [--chain base] [--mode snipe]

Getting Started from Zero

Prerequisites

• OpenClaw running (the agent runtime)
• Bankr skill installed (~/.openclaw/skills/bankr/) with a valid API key — this is what executes on-chain trades. Sign up at bankr.bot to get your API key, then add it to ~/.openclaw/skills/bankr/config.json
• Python 3.8+ and jq
• A funded wallet (Solana and/or EVM) — Bankr creates wallets for you on supported chains (Base, Solana, ETH, Polygon, Unichain). Fund them before trading.

Step-by-Step

1. Install tradr:

   cd ~/.openclaw/skills/tradr   # or wherever you unpacked the skill
   ./scripts/setup.sh            # creates config, installs systemd service
   

2. Configure your wallets: Edit config.json and add your wallet addresses under wallets. These are used for on-chain balance verification (read-only — tradr never touches your private keys).

3. Tune your strategy:

   • score_to_size — how much USD to spend at each confidence level
   • modes — exit behavior profiles (stop loss, take profit, trailing stop)
   • mcap_ceiling_usd — maximum market cap for entries

4. Start the exit manager:

   sudo systemctl start tradr-exit-manager
   sudo systemctl status tradr-exit-manager  # verify it's running
   

5. Connect a signal source: tradr doesn't generate signals — you bring your own. See adapters/README.md for the interface spec and adapters/example-adapter.py for a working template.

   Or feed trades manually:

   python3 scripts/tradr-enter.py 0xABC... --score 5 --chain base --token PEPE
   

6. Monitor via dashboard: The dashboard/index.html file provides a real-time dashboard. It expects four API endpoints:

   • GET /api/positions — returns positions.json contents
   • GET /api/trades — returns trade-log.jsonl as JSON array
   • GET /api/tradr-config — returns config.json contents
   • GET /api/health — returns system health (optional)

   You can serve these from any HTTP server that reads the flat files, or embed the dashboard in your existing server.