Skip to content

galleonlabs/crypto-defi-skills / packages/hyperliquid/skills/hyperliquid-monitor

hyperliquid-monitor

Verified

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.

FileKindSize
ATTRIBUTION.mdmarkdown948 B
LICENSEother1.0 KB
SKILL.mdskill md3.7 KB
agents/openai.yamlconfig226 B
references/authoritative-state.mdmarkdown2.4 KB
references/official-tools.mdmarkdown1.3 KB
references/output-contract.mdmarkdown966 B
references/protection-and-incidents.mdmarkdown2.0 KB
references/stream-discipline.mdmarkdown3.0 KB
scripts/funding.mjsexecutablescript2.6 KB

references/stream-discipline.md

View on GitHub
# Stream discipline

## State model

Treat a stream as `connecting`, `snapshot`, `live`, `gapped`, `reconciling`, or `stopped`. Only `live` data inside its freshness bound can produce `not-triggered`.

## Start

1. Record network, subscriptions, user address, DEX, and start time.
2. Fetch a REST snapshot for stateful subjects.
3. Subscribe and identify which first messages are snapshots.
4. Deduplicate by stable identifiers such as trade ID, order ID, client order ID, sequence, or timestamp plus payload identity.
5. Declare live only after snapshot and stream positions agree or their ordering is reconciled.

## Heartbeat and freshness

Send the documented ping and require a recent pong or data heartbeat. Enforce connection, subscription, message, and condition-evaluation freshness separately. A running process with an old last message is not healthy.

## Reconnect

On disconnect:

1. Enter `gapped` and stop clean-negative alerts.
2. Record the last confirmed event time and identifiers.
3. Reconnect and resubscribe.
4. Backfill the gap with REST history where available.
5. Deduplicate overlapping events.
6. Fetch current account and order snapshots.
7. Return to `live` only after reconciliation.

If the available history cannot cover the gap, report the interval as unknown.

## Event rules

- Do not treat the initial user-fills snapshot as new fills.
- Open candles update repeatedly; label intrabar evaluation or wait for close.
- Book updates need a fresh snapshot after a gap unless the feed supplies complete sequencing and replay.
- WebSocket acknowledgements prove subscription acceptance, not data freshness.
- Callbacks may alert or persist evidence. They must not invoke an exchange write.

Respect current connection, subscription, message, in-flight, IP, and address limits from the official rate-limit page. Back off on rate limits instead of increasing concurrency.

## User-defined watches

For a requested watch, retain exact account/market, condition and units, evaluation
cadence or event source, freshness limit, end time or stop rule, notification policy,
and last delivered event ID. Reuse an existing suitable scheduler or stream exposed
by the harness; a new daemon, trading provider or LLM call for every tick is optional.
Use deterministic comparisons for simple thresholds and reserve model interpretation
for the resulting evidence or ambiguous conditions.

Create or update a watch only through a real supported scheduling capability. Record
its returned identifier and active state before claiming it is running. If no such
tool exists, complete a one-time observation and return the unscheduled watch spec.
An open conversation or a proposed script is not a running monitor.

Unless the user requests periodic reports, notify on meaningful state changes,
incidents or required input. Deduplicate repeated alerts and record recovery from
unavailable state. Stop or expiry ends notifications, not exchange protection or
positions. No watch condition authorizes a trading action.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall