Wheelman

A trading bot, a command line and a local MCP server for Knockout and Minute. You run it with your own wallet and your own RPC endpoint.

Wheelman is an open-source bot, command line and local MCP server for Knockout and Minute. It runs on your machine, with your wallet and your RPC endpoint. It is built on the SDK, @rekt-trading/1000x. Source and full reference: the Wheelman repository. License: Apache-2.0.

What it does

command	what it does
markets	every market: open or not, stake bounds, leverage, fees
preview <market> <long|short> <usd>	the stake, the barrier, and the payout at the target and at the barrier, after every fee
open <market> <long|short> <usd>	one Knockout position (--target, --timer), or a Minute round (--minute)
close <id>	a close request; the venue’s keepers complete it
positions	open positions, live rounds, balances, today’s result
run [strategy]	the bot, with one strategy
session start|status|end	a session key for an agent
mcp	a stdio MCP server with the same commands as tools

Every command takes -o json and prints one line: {"ok": true, "data"} or {"ok": false, "error": {"category", "code", "message", "retryable"}}. See Error handling.

The bot comes with five strategies (knockout-momentum, knockout-fade, knockout-straddle, minute-trend, minute-schedule) and a template for your own. Every parameter has a default and a bound. The defaults are starting points, not recommendations.

Your wallet, your keys

• Wheelman holds no funds and hosts nothing. Your wallet signs, or a session key you authorise does.
• Agents trade with a session key, never with your wallet. wheelman session start --allowance 20 --expires 24h authorises a new key to spend at most the allowance, in USDC, until the expiry. The program enforces both. wheelman session end revokes it. See Session keys.
• Risk limits apply before every open, from the bot, the command line or an agent: the largest stake, the most open positions, a daily loss stop and a minimum balance. Wheelman does not trade without a daily loss stop. A close is never blocked.
• --paper simulates fills and sends nothing. --dry-run builds and simulates the real transaction on mainnet and sends nothing. A paper result does not say what live trading pays.

Install

Wheelman needs Node 22.18 or later. The SDK alone needs Node 20.19 or later, or Node 22.12 or later.

npm install -g @rekt-trading/wheelman
wheelman setup
wheelman markets
wheelman open BTC long 1 --paper

To run from source instead, clone the repository and run npm install && npm link in it.

Use it from an agent

The MCP server serves markets, preview, positions and session_status. With a session key it adds open and close, signed by the session key. With --paper it adds them as paper-only. It never signs with the owner’s key.

claude mcp add wheelman -- node /path/to/wheelman/src/cli.ts mcp --env /path/to/agent.env

agent.env holds RPC_URL, OWNER, SESSION_KEYPAIR_PATH and the risk limits, and no owner key. The repository also has a skill file for agents, skills/wheelman/SKILL.md, and the setup for Codex and Cursor: README.