跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

desk-execution-protocol

The Execution Trader's procedure for turning an approved ticket into one Hyperliquid action and reconciling it - the pre-send checklist, order construction rules, single-send discipline, unknown-result handling and the execution report. Use before and after every send, cancel, modify, leverage change or close.

galleonlabs · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add galleonlabs/hypergrok-trading-desk --skill desk-execution-protocol

技能说明


name: desk-execution-protocol description: The Execution Trader's procedure for turning an approved ticket into one Hyperliquid action and reconciling it - the pre-send checklist, order construction rules, single-send discipline, unknown-result handling and the execution report. Use before and after every send, cancel, modify, leverage change or close. license: MIT metadata: version: "1.1.1" author: Galleon Labs category: desk

Execution protocol

This is the only skill on the desk that ends with a request to Hyperliquid's /exchange endpoint, and only the Execution Trader uses it. The API mechanics live in hyperliquid-orders and hyperliquid-positions; this skill is the discipline around them.

Inputs

  • The proposal file /workspace/trading-desk/proposals/<id>.md with a Risk Manager PASS and exact ticket fields.
  • The user's approval line, by id, in chat, after the ticket was shown, inside the ticket's expiry.
  • The desk computer configured per hyperliquid-setup: HYPERLIQUID_NETWORK, HYPERLIQUID_ACCOUNT_ADDRESS, and the API wallet key available to scripts from the environment (never printed).

Pre-send checklist

Run every item and write the result under ## execution before sending. Any failure: do not send, name the item, hand back to the Desk Lead.

  1. Ticket integrity. Id, PASS and approval refer to the same ticket text. If the Desk Lead edited the ticket after the PASS, it goes back to Risk.
  2. Network. HYPERLIQUID_NETWORK equals the ticket's network. Mainnet is never assumed.
  3. Account and wallet. HYPERLIQUID_ACCOUNT_ADDRESS equals the ticket's account. The API wallet still acts for it (a read that requires the agent to be approved, or extraAgents for the account, shows the wallet address). If the desk has never sent from this wallet on this network, send a tiny testnet-style rehearsal on testnet first, not on mainnet.
  4. Price still valid. Fresh mid from allMids is within the ticket's slippage tolerance of the ticket price. For a stop or take-profit ticket, the trigger price is on the correct side of the current mark.
  5. Formatting. Asset index from live meta; price rounded to at most 5 significant figures and at most 6 - szDecimals decimals for perps (8 - szDecimals for spot); size rounded down to szDecimals; notional at least 10 USD; leverage on the account for that market already equals the ticket's leverage (set it first with a separate approved action if not).
  6. cloid and expiry. Generate a fresh 16-byte client order id (0x + 32 hex chars), write it to the proposal file, and put it on the order. One cloid per order, never reused. Set expiresAfter on the send, a minute out (hyperliquid-advanced), and write that deadline beside the cloid. The cloid makes a duplicate detectable; expiresAfter is what later makes the original provably dead. A send with neither cannot be cleanly recovered from an unknown result.
  7. One action. Entry plus its stop and take-profit go in one order action with grouping: normalTpsl (children sized to the entry, placed when it fills). Protection for an existing position is a standalone reduce-only trigger. Anything else in the ticket that is a different action type (leverage change, cancel) is a separate, separately approved step.
  8. Nothing else pending. No other unreconciled send from this desk in the last few minutes. If there is, reconcile it first.

Send

  • Send exactly once. Do not wrap the send in a retry loop. Set a finite timeout (10-15 seconds is plenty).
  • Capture the raw response and the send timestamp to the millisecond.
  • Interpret statuses per hyperliquid-orders: resting (oid), filled (totalSz, avgPx, oid), waitingForTrigger, waitingForFill, or an error string. A top-level status: err is an action-level rejection: nothing was placed.

Unknown results

A timeout, connection reset, HTTP 5xx, or a client exception after the request left the machine is an unknown result. Treat it as possibly executed:

  1. Do not resend.
  2. Query orderStatus for the cloid; check openOrders and userFills for it; check clearinghouseState for a position change.
  3. If found: proceed to reconciliation as if the response had arrived, and record that the original response was lost.
  4. If not found: a negative check is not proof. The original may still be in flight and can land after any number of clean reads. Do not let two quiet checks authorise a replacement.
  5. The ticket is dead only when the original is incapable of arriving. That is the send's expiresAfter deadline passing (the exchange rejects it after that), confirmed by one more check once the deadline is behind you. If the send carried no expiresAfter, you cannot prove it: burn the nonce with a noop and confirm it landed, or stop and hand the decision to the user. Never assume elapsed time alone.
  6. Then report unconfirmed, original expired at <UTC> to the Desk Lead. A new send needs a fresh approval by id, because the user must know the first one may still appear.

Reconciliation

Immediately after the response, and again when fills arrive:

  • orderStatus by cloid or oid: the exchange's view of the order.
  • openOrders / frontendOpenOrders: resting orders including trigger children.
  • userFills (or userFillsByTime for the window): fill price, size, fee, crossed (taker or maker), timestamp.
  • clearinghouseState: position size, entry, leverage, liquidation price, margin used.

Write the reconciled facts under ## reconciliation, post the execution report on the floor (format in agents/execution-trader.md), and DM the Trade Reviewer with the id and the report.

Cancels, modifies, leverage, closes

Each is its own ticket (suffix -B, -C...) with its own PASS and approval by id, unless the user has written a standing approval into desk.md for that exact class of action on that network.

  • Cancel: by cloid where you have it, else by oid
阅读完整来源 ↗