> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rekt.money/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`](https://docs.rekt.money/sdk/installation). Source and full reference: [the Wheelman
repository](https://github.com/Asymmetra/rekt-wheelman). 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](https://docs.rekt.money/sdk/errors.md).

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](https://docs.rekt.money/sdk/sessions.md).
* **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.

```sh theme={"dark"}
npm install -g @rekt-trading/wheelman
wheelman setup
wheelman markets
wheelman open BTC long 1 --paper
```

To run from source instead, clone [the repository](https://github.com/Asymmetra/rekt-wheelman) 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.

```sh theme={"dark"}
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](https://github.com/Asymmetra/rekt-wheelman#agents).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.