Hyperliquid Monitor

Reconcile Hyperliquid state and live risk

Reconstruct current exchange state and distinguish safe, triggered, and unavailable observations.

If a skill rule blocks progress, cite its file and exact rule, explain the missing input or authority, and continue independent work within this skill's boundary. User instructions govern workflow and style defaults; they do not bypass tool or financial controls.

Tool selection

When connecting or choosing tools, read official tools. Reuse a suitable maintained upstream capability before implementing new integration code; tool adoption stays optional and never supplies wallet authority.

First task and connected workflow

Reconcile one requested public user account from read-only tools and report positions, protection, timestamps and gaps. A failed read is unavailable, never an empty healthy account. Read agent integration and handoffs on first use or when a tool or related skill is missing.

Task handling

Reuse the requested account or position identity, then verify it from current reads. Ask only for missing identity or monitoring constraints; never substitute another account. Finish unaffected checks when a source fails and mark the affected result unavailable. Report the current state, material changes, and next required read concisely, retaining the output contract.

Workflow

1. Bind the network, user account address, account abstraction mode, DEX, markets, observation time, freshness bound, and requested condition.
2. Read authoritative state. Query the account or subaccount being monitored, never the API wallet address.
3. Reconcile positions, balances, open orders, trigger details, order status, fills, funding, ledger updates, fee tier, and action budget. Under unified or portfolio margin, include spot clearinghouse and borrow/lend state.
4. Check every open position against protection and incidents. Match stop side, reduce-only state, trigger, size, and position-tied status.
5. Normalize funding by its stated interval. Use node scripts/funding.mjs --help for arithmetic. Preserve funding signs from the account's perspective.
6. For continuous work, use stream discipline. Snapshot first, deduplicate, heartbeat, detect gaps, and reconcile after reconnect.
7. Evaluate the condition as exactly one of triggered, not-triggered, or unavailable. A failed, empty, stale, partial, or gapped read is unavailable.
8. Emit the monitor contract. Alerts state facts and open a plan; they never act.

Hard rules

• frontendOpenOrders or an equivalent detailed stream is required to prove trigger and reduce-only properties.
• Order response text is not final state. Use order status, open orders, fills, and position state together.
• liquidationPx is a live estimate. Cross, unified, and portfolio modes couple risk across positions and balances.
• The first fills message on a subscription may be a snapshot. Do not alert on it as new activity.
• An open candle changes until close. Label intrabar signals.
• WebSocket reconnect without backfill creates an unknown interval.
• A scheduled cancel can remove protective stops. It is not a position-aware safety system.

Boundary

Do not place, modify, cancel, close, change leverage, transfer, or submit any exchange action. State the exact next read or unsigned action needed. Route a requested action to hyperliquid-plan or hyperliquid-execute.