Katbot Trading

---

name: katbot-trading version: 0.5.0 description: Live crypto trading on Hyperliquid via Katbot.ai. Signal-triggered research → recommendation → execution workflow with Market Intelligence, research, and configurable signal monitoring.

Note: Homepage URL removed to avoid GitHub API rate limit errors during publish

metadata: { "openclaw": { "emoji": "📈", "requires": { "bins": ["python3", "openclaw"], "env": ["KATBOT_HL_AGENT_PRIVATE_KEY"] }, "primaryEnv": "KATBOT_HL_AGENT_PRIVATE_KEY", "install": "pip install -r requirements.txt" } }

---

Katbot Trading Skill

This skill teaches the agent how to use the Katbot.ai API to manage a Hyperliquid trading portfolio through a signal-driven research pipeline.

Portfolio Types

| Type | Description | |------|-------------| | HL_PAPER | Paper trading on Hyperliquid (no real funds). Formerly called PAPER. | | HYPERLIQUID | Live trading on Hyperliquid (agent key required, builder fee must be approved). |

Workflow

Setup → Configure Signal Triggers → Signal fires → Market Intel enrichment
     → Research → (user confirms apply?) → Recommendation → (user confirms) → Execution → Monitor

Capabilities

1. Signal Triggers: Configurable 10-minute-cadence monitor over Katbot Market Intelligence. Fires on clear Momentum, Volume-Breakout, Whale-Activity, or Trending signals and auto-starts the research→recommendation workflow. 2. Market Intelligence: Read trending tokens, sentiment, whale flow/activity, and composite token intelligence from /market-intelligence/*. Used by the signal trigger and as enrichment context for recommendations. 3. Research: Run Katbot AI research tasks (momentum, volume, whale activity, etc.) and reuse non-expired results to seed recommendations. 4. Recommendations: Get AI-powered trade setups (Entry, TP, SL, Leverage). Requires a primary agent assigned to the portfolio. 5. Execution: Execute and close trades on Hyperliquid with user confirmation. 6. Portfolio Tracking: Monitor open positions, uPnL, balances, timeseries, and chain info. 7. Agent Management: Create, configure, and assign AI agents to portfolios. 8. Conversation History: View and clear agent conversation history per portfolio. 9. Subscription & Plans: Check feature usage limits and available plans.

Tools

All tool scripts live exclusively in {baseDir}/tools/ — this is the single canonical location. There are no copies elsewhere in the project. Always reference tools via {baseDir}/tools/