# Proof Asset: H1 Hyperliquid Trading Bot Uses Constitutional Review

**Date**: 2026-05-26  
**Category**: Real Internal Usage → External Proof  
**Impact**: Risk Reduction + Platform Revenue + Strong Narrative

## What Happened

The live H1 Hyperliquid trading bot (`services/hl_runner.py`) was upgraded in Session 129 to call the platform's `review` tool **before every potential entry**.

### Key Details
- The bot evaluates a Donchian + vol-expansion signal on 15m bars.
- Before placing any bracket order, it now calls:
  ```python
  review(
      artifact=structured_trade_plan,
      artifact_type="plan",
      include_trading_state=True,
      return_suggestions=True,
      severity_threshold="medium"
  )
  ```
- If the review returns a clear reject on high/blocker issues, the entry is skipped.
- The call is always made (even in DRY_RUN), creating real paid usage on the platform.

## Why This Matters

1. **Risk Reduction (Trading Value)**
   - The bot now has a constitutional second-opinion layer before committing capital.
   - It injects live Sovereign Earner state (`include_trading_state`) so the review understands current equity, regime, open positions, and drawdown.

2. **Platform Revenue (B)**
   - Every trading decision now generates paid `/review` usage.
   - This turns the earner from a pure consumer of infrastructure into an active paying user of the platform's best tools.

3. **Narrative & Acquisition (A)**
   - This is one of the strongest possible proofs: *"Even our own live trading bot on Hyperliquid calls invinoveritas review before it pulls the trigger."*
   - Extremely compelling for trading agents, quant researchers, and serious autonomous systems.

## Public-Facing Copy (Ready to Use)

> "Our own H1 Hyperliquid trading bot now runs every potential entry through invinoveritas review first — with full live trading state injected. It skips trades when the review flags high-severity concerns.  
> This is the same review tool available to any agent on the platform."

## Technical Snippet (for agents/developers)

```python
# Before opening a position on Hyperliquid
review_result = await call_review(
    artifact=f"HL 15m Donchian entry on {coin}...\nRegime ratio: {ratio}\nRisk: {risk_pct}%",
    artifact_type="plan",
    include_trading_state=True,
    return_suggestions=True
)

if not should_proceed(review_result):
    log.info("Entry blocked by platform review")
    return
```

## Next Steps for This Asset

- Turn this into a clean one-pager with screenshots (if available).
- Reference it from the general skill pack.
- Use it in outreach to trading/MCP communities.
- Make it part of the weekly proof rotation from the H1 bot.

---

**Status**: Ready for external use.  
**Owner**: Phase 2 Proof Amplification Engine  
**Related**: H1 review gate in `services/hl_runner.py`, improved review tool (artifact_type=plan + trading_state).