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/authoritative-state.md

View on GitHub
# Authoritative state

Use the account or subaccount address whose state matters. The API wallet is a signer, not the account. Querying its address can return an empty account that looks flat.

## Core reads

| Question | Read |
|---|---|
| Account mode | `userAbstraction` |
| Perp positions and cross margin | `clearinghouseState`, with `dex` where needed |
| Spot balances and holds | `spotClearinghouseState` |
| Portfolio borrow and supply | `borrowLendUserState` plus current reserve states |
| Detailed resting orders | `frontendOpenOrders` or equivalent detailed stream |
| Order lifecycle | `orderStatus` by client order ID or order ID, `historicalOrders` |
| Fills | `userFillsByTime`, paginated and deduplicated by trade ID |
| Funding | `userFunding`, preserving account sign |
| Non-funding balance changes | `userNonFundingLedgerUpdates` |
| Effective fees | `userFees` |
| Action budget | `userRateLimit` |
| Market mark and metadata | `metaAndAssetCtxs`, `meta` |
| Per-market allowance | `activeAssetData` |

Time-ranged responses are bounded. Paginate from the last returned timestamp and deduplicate records that share the boundary.

## Account modes

Standard mode isolates spot and each perp DEX balance. Unified and portfolio modes use spot clearinghouse balances across products, so a single DEX state is incomplete. Portfolio mode also needs current borrow/lend state and its combined liquidation ratio.

Query every DEX with an open position or order. A default-DEX-only check can miss HIP-3 exposure. Report which scope each read covered: default-DEX perp equity is not unified-account value, and an account-value denominator observed today does not establish historical percentage returns.

## Reconciliation

For an order action, combine:

1. `orderStatus` for each client order ID or order ID.
2. Detailed open orders for resting, trigger, reduce-only, and grouping state.
3. Fills since the send time for executed size, price, fee, and trade ID.
4. Account positions and balances for net exposure.

No one source proves the whole outcome. If they disagree, report an incident state and keep every raw timestamp.

## Freshness

Each read carries network, request, server or payload time where available, local receive time, and maximum accepted age. Mixed-time snapshots disclose their skew. Do not compute a precise liquidation or open-risk verdict from states observed far apart.
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