Hyperliquid monitor
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
- Bind the network, user account address, account abstraction mode, DEX, markets, observation time, freshness bound, and requested condition.
- Read authoritative state. Query the account or subaccount being monitored, never the API wallet address.
- 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.
- Check every open position against protection and incidents. Match stop side, reduce-only state, trigger, size, and position-tied status.
- Normalize funding by its stated interval. Use
node scripts/funding.mjs --help for arithmetic. Preserve funding signs from the account's perspective.
- For continuous work, use stream discipline. Snapshot first, deduplicate, heartbeat, detect gaps, and reconcile after reconnect.
- Evaluate the condition as exactly one of
triggered, not-triggered, or unavailable. A failed, empty, stale, partial, or gapped read is unavailable.
- 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.
1---2name: hyperliquid-monitor3description: Reconcile a Hyperliquid account, position, order, fill, funding stream, liquidation buffer, or watch from current exchange data. Use when the user asks what is open, whether protection exists, whether an order filled, how close liquidation is, what changed, or to watch and alert on a condition. Read-only; not for placing, changing, or canceling orders.4license: MIT5---67# Hyperliquid monitor89Reconstruct current exchange state and distinguish safe, triggered, and unavailable observations.1011If 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.1213## Tool selection1415When connecting or choosing tools, read [official tools](references/official-tools.md). Reuse a suitable maintained upstream capability before implementing new integration code; tool adoption stays optional and never supplies wallet authority.1617## First task and connected workflow1819Reconcile 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](references/agent-integration.md) on first use or when a tool or related skill is missing.2021## Task handling2223Reuse 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.2425## Workflow26271. Bind the network, user account address, account abstraction mode, DEX, markets, observation time, freshness bound, and requested condition.282. Read [authoritative state](references/authoritative-state.md). Query the account or subaccount being monitored, never the API wallet address.293. 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.304. Check every open position against [protection and incidents](references/protection-and-incidents.md). Match stop side, reduce-only state, trigger, size, and position-tied status.315. Normalize funding by its stated interval. Use `node scripts/funding.mjs --help` for arithmetic. Preserve funding signs from the account's perspective.326. For continuous work, use [stream discipline](references/stream-discipline.md). Snapshot first, deduplicate, heartbeat, detect gaps, and reconcile after reconnect.337. Evaluate the condition as exactly one of `triggered`, `not-triggered`, or `unavailable`. A failed, empty, stale, partial, or gapped read is unavailable.348. Emit [the monitor contract](references/output-contract.md). Alerts state facts and open a plan; they never act.3536## Hard rules3738- `frontendOpenOrders` or an equivalent detailed stream is required to prove trigger and reduce-only properties.39- Order response text is not final state. Use order status, open orders, fills, and position state together.40- `liquidationPx` is a live estimate. Cross, unified, and portfolio modes couple risk across positions and balances.41- The first fills message on a subscription may be a snapshot. Do not alert on it as new activity.42- An open candle changes until close. Label intrabar signals.43- WebSocket reconnect without backfill creates an unknown interval.44- A scheduled cancel can remove protective stops. It is not a position-aware safety system.4546## Boundary4748Do 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`.
galleonlabs