# Strategy Examples

Four supervised **runtime-v2** strategies ship as worked examples. Each is a
complete, validated recipe (`version: 2.0.0`) with its own supervised
`scanners/scan.py` (the runtime spawns a scaffold child and calls
`scan(inputs, ctx)` on `interval_seconds` — there is no producer/push model).
Each has its own README with the full thesis, scanner shape, and DSL profile.

| Strategy | Thesis | Recipe(s) | README |
|----------|--------|-----------|--------|
| **iguana** | XYZ macro index-trend — index-fund-style equity exposure on Hyperliquid, no stock-picking. Two indices, one decision per tick. | `iguana/recipe.yaml` | [iguana/README.md](iguana/README.md) |
| **raptor** | Whale copy-follow — takes a currently-winning quality trader's highest-conviction position when smart money agrees. | `raptor/recipe.yaml` | [raptor/README.md](raptor/README.md) |
| **turbine** | Funding-fade rotation — one shared signal, two recipes that differ only in sizing + DSL exit + risk (volume vs runners). | `turbine/recipe-volume.yaml`, `turbine/recipe-runners.yaml` | [turbine/README.md](turbine/README.md) |
| **spider** | Two genuinely different legs on separate wallets: `swing` (tech/AI multi-day momentum) + `scalp` (macro/majors fast mean-reversion). | `spider/swing/recipe.yaml`, `spider/scalp/recipe.yaml` | [spider/README.md](spider/README.md) |

## Quickstart

1. Install the plugin:
   ```bash
   openclaw plugins install @senpi-ai/runtime
   ```

2. Copy a recipe and fill in its wallet env var:
   ```bash
   cp iguana/recipe.yaml my-recipe.yaml
   # edit: set the strategy's wallet env var (iguana uses ${IGUANA_WALLET})
   ```

3. Set environment variables:
   ```bash
   cp ../.env.example .env
   # edit: SENPI_API_KEY plus the recipe's wallet env var
   source .env
   ```

4. Load the recipe (hot-loads, no gateway restart):
   ```bash
   openclaw senpi runtime create -p my-recipe.yaml
   ```

5. Verify:
   ```bash
   openclaw senpi runtime list
   ```

## CLI reference

- `senpi guide scanners` — scanner config fields
- `senpi guide dsl` — DSL exit: phases, lock modes, tiers, time-based cuts
- `senpi guide schema` — full YAML schema