@senpi/trading-runtime 1.0.0

package/examples/strategies/viper.yaml

@@ -0,0 +1,63 @@
+name: viper
+version: 1.0.0
+description: Moderate — candle-based breakouts via prescreener + momentum.
+
+strategies:
+  viper:
+    wallet: "${WALLET_ADDRESS}"
+    budget: 2000
+    slots: 4
+    margin_per_slot: 400
+    trading_risk: moderate
+    enabled: true
+
+scanners:
+  - name: prescreener
+    type: prescreener
+    interval: 5m
+    config:
+      topN: 30
+      minDayVolume: 1000000
+      minLeverage: 2
+      minOpenInterest: 0
+  - name: momentum
+    type: momentum
+    interval: 1m
+    config:
+      timeframe: "1h"
+      minMovePct: 1.5
+      maxCandidates: 20
+      minDayVolume: 1000000
+      minSignalScore: 0.2
+      requirePrescreened: true
+
+actions:
+  - name: open_breakout
+    action_type: OPEN_POSITION
+    decision_mode: llm
+    decision_model: claude-sonnet-4-20250514
+    scanners: [momentum]
+    min_confidence: 6
+    context: [signal]
+    decision_prompt: |
+      Evaluate the momentum breakout signal. Reply with JSON: {"execute": true|false, "actionType": "OPEN_POSITION", "confidence": 1-10, "reasoning": "...", "payload": {"asset": "SYMBOL", "direction": "LONG"|"SHORT"}}.
+
+exit:
+  engine: dsl
+  interval_seconds: 30
+  dsl_presets:
+    default:
+      phase1:
+        enabled: true
+        max_loss_pct: 4.0
+        consecutive_breaches_required: 3
+      phase2_trigger_tier: 0
+      phase2:
+        enabled: true
+        retrace_threshold: 1.5
+        consecutive_breaches_required: 1
+        tiers:
+          - { trigger_pct: 10, lock_pct: 5 }
+          - { trigger_pct: 20, lock_pct: 12 }
+          - { trigger_pct: 35, lock_pct: 22, retrace: 1.2 }
+          - { trigger_pct: 50, lock_pct: 35, retrace: 1.0 }

package/examples/strategies/wolf.yaml

@@ -0,0 +1,60 @@
+name: wolf
+version: 1.0.0
+description: Aggressive — early entry on FIRST_JUMP from emerging_movers.
+
+strategies:
+  wolf:
+    wallet: "${WALLET_ADDRESS}"
+    budget: 1000
+    slots: 3
+    margin_per_slot: 300
+    trading_risk: aggressive
+    enabled: true
+
+scanners:
+  - name: emerging_movers
+    type: emerging_movers
+    interval: 20s
+    config:
+      topN: 25
+      minRankJump: 5
+      minTopTradersGain: 0.1
+      minScansBeforeSignals: 2
+      historyLimit: 60
+      immediateJumpThreshold: 10
+      deepClimbRankThreshold: 25
+      contribExplosionMultiplier: 3.0
+      firstJumpMinPrevRank: 30
+
+actions:
+  - name: open_on_jump
+    action_type: OPEN_POSITION
+    decision_mode: llm
+    decision_model: claude-sonnet-4-20250514
+    scanners: [emerging_movers]
+    min_confidence: 6
+    context: [signal]
+    decision_prompt: |
+      Evaluate the signal. Reply with JSON: {"execute": true|false, "actionType": "OPEN_POSITION", "confidence": 1-10, "reasoning": "...", "payload": {"asset": "SYMBOL", "direction": "LONG"|"SHORT"}}.
+
+exit:
+  engine: dsl
+  interval_seconds: 30
+  dsl_presets:
+    default:
+      phase1:
+        enabled: true
+        max_loss_pct: 3.0
+        consecutive_breaches_required: 3
+      phase2_trigger_tier: 0
+      phase2:
+        enabled: true
+        retrace_threshold: 1.5
+        consecutive_breaches_required: 1
+        tiers:
+          - { trigger_pct: 10, lock_pct: 5 }
+          - { trigger_pct: 20, lock_pct: 14 }
+          - { trigger_pct: 30, lock_pct: 22, retrace: 1.2 }
+          - { trigger_pct: 50, lock_pct: 40, retrace: 1.0 }
+          - { trigger_pct: 75, lock_pct: 60, retrace: 0.8 }
+          - { trigger_pct: 100, lock_pct: 80, retrace: 0.6 }

package/examples/yamls/sample-with-dsl-and-emerging-movers.yaml

@@ -0,0 +1,111 @@
+name: wolf #required - name of the trading-strategy
+version: 7.0.0 #required
+description: > #required
+  Autonomous aggressive multi-strategy trading. Enter early on emerging movers,
+  protect with tight DSL, cut dead weight fast, rotate into strength.
+
+# ── STRATEGIES ──
+strategies: #required
+  aggressive-momentum: #required - name of the strategy
+    wallet: "0x71ce3f0e27c178cbdcf01c4d068278034df75fbc"
+    budget: "100"
+    slots: 3
+    margin_per_slot: 150
+    trading_risk: aggressive
+    enabled: true
+
+# ── SCANNERS ──
+scanners: #required 
+  - name: emerging_movers #required 
+    type: emerging_movers #required 
+    interval: 20s #required 
+    blocked_assets: [] #optional
+    config: #Can be different for each scanner.
+      topN: 25
+      minRankJump: 5
+      minTopTradersGain: 0.1
+      minScansBeforeSignals: 2
+      historyLimit: 60
+
+actions: #required 
+  - name: wolf_entry #required 
+    action_type: OPEN_POSITION #required 
+    decision_mode: llm #required 
+    decision_model: claude-sonnet-4-6 #required 
+    scanners: [emerging_movers] #required 
+    min_confidence: 2 #required 
+    context: #optional
+      - type: signal
+        value: emerging_movers
+    decision_prompt: | #optional 
+      You evaluate emerging mover signals for the WOLF multi-strategy system.
+      WOLF enters early on first jumps — before the peak, not at it. Speed is edge.
+
+      SIGNAL DATA:
+      {{emerging_movers}}
+
+      SIGNAL PRIORITY (strict — act on highest priority first):
+      1. FIRST_JUMP: Jumped 10+ ranks from #25+ in one scan, wasn't in top 50 before.
+         ENTER IMMEDIATELY. 2 reasons is enough. vel > 0 is enough.
+      2. CONTRIB_EXPLOSION: 3x+ contribution spike from rank #20+. ENTER.
+         Never downgrade for erratic history.
+      3. IMMEDIATE_MOVER: 10+ rank jump from #25+ but not first jump.
+         ENTER if not erratic and not low velocity.
+      4. DEEP_CLIMBER: Steady climb from #30+, vel >= 0.03, 3+ reasons.
+         Route to conservative strategy if available.
+
+      ROUTING:
+      - FIRST_JUMP/CONTRIB_EXPLOSION → aggressive strategy
+      - DEEP_CLIMBER → conservative if available, else aggressive
+      - Never duplicate same asset within one strategy (cross-strategy OK)
+
+      ANTI-PATTERNS:
+      - Rank #1-10 for 2+ scans = SKIP
+      - 4+ reasons at rank #5 = SKIP
+      - Counter to BTC hourly trend = SKIP
+      - Burned asset today = SKIP
+
+      ROTATION (slots full + FIRST_JUMP):
+      - Weakest has negative ROE + SM conviction <= 1 → CUT, ENTER new
+      - Weakest is Tier 2+ or SM conviction 3+ → HOLD
+      - Positions younger than {{rotation_cooldown_minutes}}min → never rotate out
+
+      XYZ EQUITIES: Ignore trader count. Use reasons + rank velocity.
+
+      Respond with execute=true and actionType="OPEN_POSITION".
+      Put trade details in the payload object:
+      {
+        "execute": true,
+        "actionType": "OPEN_POSITION",
+        "confidence": 1-10,
+        "reasoning": "one sentence",
+        "payload": {
+          "asset": "<coin_ticker>",
+          "direction": "LONG" or "SHORT",
+          "rotate_out": "<asset_to_cut>" (optional, only when rotating)
+        }
+      }
+      Set execute=false if no trade should be taken.
+
+# ── EXIT ──
+exit: #required
+  engine: dsl
+  interval_seconds: 30
+  dsl_presets:
+    with_phases:
+      phase1:
+        enabled: true
+        consecutive_breaches_required: 3
+        max_loss_pct: 3.0
+      phase2_trigger_tier: 0
+      phase2:
+        enabled: true
+        retrace_threshold: 1.5    # 1.5% from high-water (global); overridden per tier below
+        consecutive_breaches_required: 1
+        tiers:
+          - { trigger_pct: 10,  lock_pct: 5 }
+          - { trigger_pct: 20,  lock_pct: 14 }
+          - { trigger_pct: 30,  lock_pct: 22, retrace: 1.2 }
+          - { trigger_pct: 50,  lock_pct: 40, retrace: 1.0 }
+          - { trigger_pct: 75,  lock_pct: 60, retrace: 0.8 }
+          - { trigger_pct: 100, lock_pct: 80, retrace: 0.6 }

package/openclaw.plugin.json

@@ -0,0 +1,15 @@
+{
+  "id": "trading-runtime",
+  "name": "Senpi Trading Runtime",
+  "description": "Senpi trading runtime plugin for OpenClaw",
+  "version": "1.0.0",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "stateDir": { "type": "string", "description": "Directory for plugin and strategy state (default: ~/.openclaw/senpi-state)" },
+      "apiKey": { "type": "string", "description": "API key when mcpTransport is not provided by the gateway" }
+    }
+  },
+  "uiHints": {}
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@senpi/trading-runtime",
+  "version": "1.0.0",
+  "description": "Trading runtime plugin for OpenClaw",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/",
+    "openclaw.plugin.json",
+    "examples/"
+  ],
+  "scripts": {
+    "setup:hooks": "sh -c 'git rev-parse --git-dir >/dev/null 2>&1 && git config core.hooksPath .githooks || true'",
+    "prepare": "npm run setup:hooks",
+    "build": "npm i && tsc",
+    "start": "node dist/index.js",
+    "dev": "npm run build && node dist/index.js",
+    "watch": "tsc --watch",
+    "test": "vitest run",
+    "run:dsl:mock": "node dist/scripts/run-dsl-standalone-mock.js",
+    "run:dsl:live": "node dist/scripts/run-dsl-standalone-live.js",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "dotenv": "^16.4.5",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0",
+    "mcporter": "^0.7.3",
+    "yaml": "^2.8.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.2.0"
+  },
+  "devDependencies": {
+    "@sinclair/typebox": "^0.34.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "openclaw": {
+    "type": "extension",
+    "extensions": [
+      "./dist/index.js"
+    ]
+  }
+}