An AI trading agent for Hyperliquid: Claude trades perps from Claude Code, with an exact stop and target on every order.
pathiel is a free, open-source Hyperliquid MCP server and Claude Code plugin: 30 tools that read Hyperliquid perpetual futures markets and your account, and place orders, from Claude Code, Claude Desktop, Cursor or any MCP client.
Real money. pathiel runs on Hyperliquid mainnet. With no key it only reads; once you add a key, orders are real. Practice on testnet with one line: PATHIEL_NETWORK=testnet.
Illustration of how a bracket is built. Not market data, not a result.
One market at a time, studied hard.
One desk trades at a time, crude oil by default, holding one position. Every input it reads is chosen for that market.
- Brent (xyz:BRENTOIL) on mainnet, WTI on testnet; one position per account
- EIA weekly crude stocks, read as the surprise against the 4-week average
- CFTC positioning, Polymarket and Kalshi odds on Iran, Hormuz and OPEC+
- Sanctions and the Federal Register; Hyperliquid funding and open interest
- The weekly EIA and API prints, plus a 47-event calendar: OPEC and IEA reports, FOMC, CPI, jobs, expiries
- A tick every 15 minutes; the thesis is rewritten daily, after each listed catalyst, a 1.5% move, a stop break or a headline alert
The most likely moves, written down.
Every brief prices the next week as 3 to 5 scenarios whose odds must sum to 100%, or the brief is rejected and rewritten.
Out if: a 1h close below the stop
Biggest risk: the worst scenario, with its odds
Next catalyst: named, with its UTC time
Every call is graded afterwards: direction hit rate and a Brier score on the odds it gave.
Example of the brief's format, not a live call.
Rules that earned their place.
A rule goes live only after a backtest or a fluke-or-edge review of real trades says so.
| Rule | Tested by |
|---|---|
| Target rests as a limit order | 26 target exits, limit vs market |
| Target 0.5% inside the day's range | 540-combination sweep |
| 2R minimum, buy dips only | Brent sweep, 30 and 50 days |
| No long under the 24h low | Flagged by the review on 10 real trades |
| No entry 2h around EIA | 52-day event study |
| Flat over the weekend | Monday-gap study, 8 Brent datasets |
Tested and dropped: breakeven stops regime filter funding-spike filter, and every rule from an 8,747-combination sweep. The review calls nothing an edge with fewer than 10 trades or p of 0.05 or more.
/plugin marketplace add Julian-dev28/pathiel
/plugin install pathiel@pathiel
/pathiel:setupSetup shows the network and the risks, builds a private Python environment and connects the MCP server.
Reading markets needs no account. To trade, connect your Hyperliquid wallet with one signature: it approves an API wallet, which can trade and never withdraw.
| Symbol | Market | Desk |
|---|---|---|
| xyz:BRENTOIL | Brent crude, HIP-3 | OIL |
| xyz:CL | WTI crude, HIP-3 | OIL |
| xyz:GOLD | Gold, HIP-3 | METALS |
| xyz:SILVER | Silver, HIP-3 | METALS |
| BTC, ETH, ... | Any main-dex perp, by name | READ + TRADE |
Desk briefs for crude oil (Brent and WTI) and metals (gold and silver) on Hyperliquid's HIP-3 markets give Claude a written call to trade from.
| Rule | Default | What happens |
|---|---|---|
| Order shape | BRACKET | Every trade is one bracket order: an entry, a stop-loss and a take-profit target, sized from your risk profile. |
| Risk at the stop | 1.00% | Default profile: at most 3x leverage, 1% of equity at risk at the stop, one position at a time. |
| Reward to risk | ≥ 2R | Orders under 2R are refused. |
| Stop vs liquidation | < 0.5 | A stop outside half the distance to liquidation is refused. |
| Live-money calls | ASK | Claude Code asks before each live-money call. Nothing trades in the background. |
| pathiel fee | 0.00% | pathiel charges no fee: no order it places carries a Hyperliquid builder fee, so you pay only Hyperliquid's own trading fee. |
Opt in with one signed statement and pathiel grades your public fills with the same fluke-or-edge harness it runs on its own trades. Results are published at least 24 hours late on the scoreboard. No payout or reward is tied to returns.
Open scoreboard →Leveraged perps can lose the whole account, fast. There is no demonstrated edge and no return is promised. This is software, not financial advice. Hyperliquid's terms bar use from restricted jurisdictions, including by US persons; pathiel does not check where you are.