- name
SKILL.md
Die Skill-Datei bleibt im Repository des Herausgebers.
Fügen Sie den kopierten Befehl in ein Terminal ein. Er installiert diese SKILL.md in dem jeweiligen Agenten.
npx skills add galleonlabs/hypergrok-trading-desk --skill hyperliquid-api-reference -a cursor -yFügen Sie den kopierten Befehl in ein Terminal ein. Er installiert diese SKILL.md in dem jeweiligen Agenten.
npx skills add galleonlabs/hypergrok-trading-desk --skill hyperliquid-api-reference -a claude-code -yFügen Sie den kopierten Befehl in ein Terminal ein. Er installiert diese SKILL.md in dem jeweiligen Agenten.
npx skills add galleonlabs/hypergrok-trading-desk --skill hyperliquid-api-reference -a codex -yFügen Sie den kopierten Befehl in ein Terminal ein. Er installiert diese SKILL.md in dem jeweiligen Agenten.
npx skills add galleonlabs/hypergrok-trading-desk --skill hyperliquid-api-reference -a grok -ySenden Sie die kopierte Nachricht in einem Grok Bot-Chat. Der Bot ruft diese SKILL.md von GitHub ab und fügt sie den Skills hinzu, die alle Ihre Bots gemeinsam nutzen.
Install this skill: https://github.com/galleonlabs/hypergrok-trading-desk/tree/HEAD/skills/hyperliquid-api-referenceVom Herausgeber
Desk-used contracts rechecked against the official docs and SDKs on 2026-10-25 (scope and evidence). Funding cap, mark-price inputs, market-order notionals and CEX funding intervals were rechecked on 2026-11-12 (evidence). This is a scoped reference, not an exhaustive inventory of the exchange's growing API. When in doubt, fetch the page: append .md to any docs URL for raw markdown, for example https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint.md.
POST /info body {"type": "<request>", ...}, unsigned; response is the bare payload. Unknown type or missing field: HTTP 422; invalid JSON: HTTP 400.POST /exchange body {"action": {...}, "nonce": <ms>, "signature": {"r","s","v"}, "vaultAddress"?: "0x...", "expiresAfter"?: <ms>}; response {"status":"ok","response":{"type":"order"|"cancel"|"default"|..., "data"?: {...}}} or {"status":"err","response":"<string>"}, both HTTP 200.Content-Type: application/json.Pagination for time-ranged reads: 500 items per response for ledger/funding style queries; use the last time as the next startTime.
L1-signed actions can be signed by an API wallet; user-signed actions need the account's main wallet (the desk never has it).
Order fields: a asset index, b isBuy, p price string, s size string, r reduceOnly, t {"limit":{"tif":"Alo"|"Ioc"|"Gtc"}} or {"trigger":{"isMarket":bool,"triggerPx":"...","tpsl":"tp"|"sl"}}, c cloid (0x + 32 hex). Order statuses: {"resting":{"oid"}}, {"filled":{"totalSz","avgPx","oid"}}, "waitingForTrigger", "waitingForFill", {"error":"..."}. Cancel statuses: "success" or {"error":"..."}.
Order status vocabulary (orderStatus, historicalOrders, WS orderUpdates): open, filled, canceled, triggered, rejected, marginCanceled, vaultWithdrawalCanceled, openInterestCapCanceled, selfTradeCanceled, reduceOnlyCanceled, siblingFilledCanceled, delistedCanceled, liquidatedCanceled, scheduledCancel, tickRejected, minTradeNtlRejected, perpMarginRejected, reduceOnlyRejected, badAloPxRejected, iocCancelRejected, badTriggerPxRejected, marketOrderNoLiquidityRejected, positionIncreaseAtOpenInterestCapRejected, positionFlipAtOpenInterestCapRejected, tooAggressiveAtOpenInterestCapRejected, openInterestIncreaseRejected, insufficientSpotBalanceRejected, oracleRejected, perpMaxPositionRejected.
Agent {source, connectionId} under domain Exchange (chainId 1337) where source is a for mainnet and b for testnet.HyperliquidSignTransaction with the action's hyperliquidChain (Mainnet/Testnet) and signatureChainId; the action's nonce/time must equal the outer nonce.User or API Wallet 0x<recovered> does not exist., not as "bad signature".-0 becomes 0.meta.universe (default dex). Read it live; never hardcode.10000 + index in spotMeta.universe; coin name PURR/USDC or @<index>; size decimals from the base token.100000 + 10000 x dex index + index; name dex:COIN.100000000 + encoding; names #<n>.6 - szDecimals decimals (perps) or 8 - szDecimals (spot). Integer prices are always valid.szDecimals. Round down on the desk./exchange weight 1 + floor(n/40). /info weight 2 for l2Book, allMids, clearinghouseState, orderStatus, spotClearinghouseState, exchangeStatus; 60 for userRole; 20 for the rest; +1 per 20 items for list queries; candleSnapshot +1 per 60 candles.min(limit + 100000, 2 x limit). Stale expiresAfter rejections cost 5x. Check the live limit reference for mode-specific constraints.{"method":"subscribe","subscription":{...}}; heartbeat {"method":"ping"} / {"channel":"pong"}; idle connections closed after 60 s. Types: allMids, notification, webData3, candle, l2Book, trades, orderUpdates, userEvents (channel "user"), userFills, userFundings, userNonFundingLedgerUpdates, activeAssetCtx, activeAssetData, userTwapSliceFills, userTwapHistory, twapStates, bbo, clearinghouseState, openOrders, spotState, allDexsClearinghouseState, allDexsAssetCtxs, outcomeMetaUpdates, fastAssetCtxs. Post /info or signed actions over the socket with {"method":"post","id":n,"request":{"type":"info"|"action","payload":{...}}}.
Price must be divisible by tick size. | Order must have minimum value of $10. | Insufficient margin to place order. | Reduce only order would increase position. | Post only order would have immediately matched, bbo was ... | Order could not immediately match against any resting orders. | Invalid TP/SL price. | No liquidity available for market order. | Order price too far from oracle | Order would cause position to exceed margin tier limit at current leverage | Order was never placed, already canceled, or filled. | User or API Wallet 0x... does not exist. | Must deposit before performing actions. User: 0x... | Invalid TWAP duration: ...
userFees; apply referral, aligned-quote, stable-pair and HIP-3 deployer/growth modifiers for the market. Actual fill fees remain the reconciliation source.app.hyperliquid-testnet.xyz/drip (needs an address that has deposited on mainnet); much tighter margin tiers; asset ids differ.for-developers/api/info-endpoint, .../info-endpoint/perpetuals, .../info-endpoint/spot, .../exchange-endpoint, .../signing, .../nonces-and-api-wallets, .../rate-limits-and-user-limits, .../tick-and-lot-size, .../asset-ids, .../error-responses, .../websocket/subscriptions, .../websocket/post-requests; trading/order-types, trading/take-profit-and-stop-loss-orders-tp-sl, trading/margining, trading/margin-tiers, trading/liquidations, trading/funding, trading/fees, trading/contract-specifications, trading/robust-price-indices, trading/sub-accounts; onboarding/testnet-faucet. All under https://hyperliquid.gitbook.io/hyperliquid-docs/.
Compact reference for the Hyperliquid API as the desk uses it - endpoints and envelopes, desk-used /info request types and /exchange actions with their signing schemes, order and status vocabularies,
---name: hyperliquid-api-referencedescription: Compact reference for the Hyperliquid API as the desk uses it - endpoints and envelopes, desk-used /info…---# skills/hyperliquid-api-reference/SKILL.mdÜbersicht
Compact reference for the Hyperliquid API as the desk uses it - endpoints and envelopes, desk-used /info request types and /exchange actions with their signing schemes, order and status vocabularies, asset ids, tick and lot rules, rate limits, WebSocket subscription list, error strings, and where the official docs are. Use to look up an exact field, request type or limit before writing a call, and to map an error string to its cause.
FAQ
Laden Sie skills/hyperliquid-api-reference/SKILL.md vom Herausgeber herunter oder kopieren Sie den Pfad und öffnen Sie das Repository. PlugMCP listet den Skill und hostet die Datei nicht.
Der Herausgeber pflegt es unter https://github.com/galleonlabs/hypergrok-trading-desk.
Claude, Cursor, Codex und Grok Build können eine SKILL.md lesen, die Sie aus dem Repository des Herausgebers hinzufügen. Grok Bot installiert sie, wenn Sie den Link zum GitHub-Ordner des Skills in einem Chat senden.
spotClearinghouseState | user | {balances:[{coin, token, hold, total, entryNtl}]} |
openOrders | user, dex? | [{coin, side (A/B), limitPx, sz, oid, timestamp}] |
frontendOpenOrders | user, dex? | adds origSz, cloid, orderType, tif, reduceOnly, isTrigger, triggerPx, triggerCondition, isPositionTpsl, children |
orderStatus | user, oid (number or cloid hex) | {status:"order", order:{order, status, statusTimestamp}} or {status:"unknownOid"} |
historicalOrders | user | [{order, status, statusTimestamp}] up to 2000 |
userFills | user, aggregateByTime? | [{coin, px, sz, side, time, startPosition, dir, closedPnl, hash, oid, crossed, fee, feeToken, builderFee?, tid, cloid?}] up to 2000 |
userFillsByTime | user, startTime, endTime?, aggregateByTime? | same, up to 2000 per call from the last 10000 |
userFunding | user, startTime, endTime? | [{time, hash, delta:{type:"funding", coin, usdc, szi, fundingRate, nSamples}}] |
userNonFundingLedgerUpdates | user, startTime, endTime? | deposits, withdrawals, transfers, liquidations, vault flows |
userTwapSliceFills | user | [{fill, twapId}] |
portfolio | user | [["day",{accountValueHistory, pnlHistory, vlm}], ["week",...], ["month",...], ["allTime",...], perp variants] |
userFees | user | {userCrossRate, userAddRate, userSpotCrossRate, userSpotAddRate, feeSchedule, activeReferralDiscount, activeStakingDiscount} |
userRateLimit | user | {cumVlm, nRequestsUsed, nRequestsCap, nRequestsSurplus} |
userRole | user | `{role: missing |
extraAgents | user | [{address, name, validUntil}] |
activeAssetData | user, coin | {leverage, maxTradeSzs:[buy,sell], availableToTrade:[buy,sell], markPx} |
maxBuilderFee | user, builder | integer (tenths of a bp) |
subAccounts | user | [{name, subAccountUser, master, clearinghouseState, spotState}] |
vaultDetails | vaultAddress, user? | vault info |
userVaultEquities | user | [{vaultAddress, equity}] |
referral, delegations, delegatorSummary, delegatorHistory, delegatorRewards, userAbstraction, borrowLendUserState, tokenDetails, spotDeployState, perpDexLimits, allPerpMetas | niche; see docs |
usdSend, spotSend, sendAsset, withdraw3, usdClassTransfer | user | no |
cDeposit, cWithdraw, tokenDelegate, userSetAbstraction | user | no |