{"uid":"cap_6wqEBso5asOCR8Iftc1zV","slug":"hyperliquid-noop-action-builder-nonce-invalidation-644aff54","name":"Hyperliquid Noop Action Builder (Nonce Invalidation)","description":"Return the Hyperliquid noop action the user must sign to mark a nonce as used for safer in-flight cancellation workflows. Errors: 400 invalid input; execution may return 422 exchange rejection or 502 provider failure. Treat spot and perp as one balance only when the account abstraction mode is \"unifiedAccount\".","url":"https://chainhilt.ai/api/v1/perp/hyperliquid/order/noop?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"nonce":{"type":"integer","minimum":0,"description":"The nonce to mark as used, in milliseconds since the epoch."},"action":{"type":"object","description":"Must be { \"type\": \"noop\" }.","additionalProperties":true},"expiresAfter":{"type":"integer","minimum":0,"description":"Millisecond timestamp after which Hyperliquid rejects the action. Signed with the action."},"vaultAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Vault or subaccount to act for; omit to act for the signer. Signed with the action."},"accountAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Signing account's address, returned as response metadata; not part of the signed action."}}},"responseSchema":{"type":"json","example":{"response":{"errors":[],"actions":[{"data":{"nonce":1710000000000,"action":{"type":"noop"},"typedData":{"types":{"Agent":[{"name":"source","type":"string"},{"name":"connectionId","type":"bytes32"}],"EIP712Domain":[{"name":"name","type":"string"},{"name":"version","type":"string"},{"name":"chainId","type":"uint256"},{"name":"verifyingContract","type":"address"}]},"domain":{"name":"Exchange","chainId":1337,"version":"1","verifyingContract":"0x0000000000000000000000000000000000000000"},"message":{"source":"a","connectionId":"0x666103cc4c87d3ba62d4387aa41c9170baae846785df2f094dfe3131bb2412fa"},"primaryType":"Agent"}},"type":"signature","chainId":42161,"protocol":"hyperliquid","submitPath":"/perp/hyperliquid/order/noop/execute"}],"warnings":[]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__8DQ9KRYmBk9BFKjqmcAT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the EIP-712 typed data for a Hyperliquid noop action that a user must sign to mark a nonce as used, enabling safer in-flight order cancellation workflows.","exampleAgentPrompt":"Prepare the Hyperliquid noop action I need to sign to consume nonce 1710000000000 on my account 0xAbCd1234abcd1234abcd1234abcd1234abcd1234 so it can't be replayed during my cancellation workflow.","exampleUseCases":[{"title":"Safe in-flight order cancellation","prompt":"I'm cancelling a Hyperliquid perp order and I need to burn nonce 1710000000001 for account 0xAbCd1234abcd1234abcd1234abcd1234abcd1234 first so it can't be replayed — give me the noop action to sign."},{"title":"Nonce invalidation for vault account","prompt":"My vault at 0xDeAd0000DeAd0000DeAd0000DeAd0000DeAd0000 is running a Hyperliquid strategy and I need to mark nonce 1710005000000 as used to prevent any in-flight race conditions — prepare the noop typed data for signing."},{"title":"Replay protection before strategy reset","prompt":"Before I reset my Hyperliquid trading bot on account 0x1111222233334444555566667777888899990000, I want to invalidate the current nonce 1710009999999 so old signed messages can't be replayed — get me the noop action."}],"resultDescription":"Returns a structured action object containing: the nonce to be consumed, the noop action type, EIP-712 typed data (types, domain with Exchange contract on chainId 1337, and message with source and connectionId), the Arbitrum chainId (42161), the protocol identifier ('hyperliquid'), and the submitPath to execute the signed noop action. No side effects occur until the returned data is signed and submitted.","failureModes":["Invalid nonce format (non-integer or negative) returns a validation error","Malformed Ethereum address (vaultAddress or accountAddress not matching 0x + 40 hex chars) returns a 400 error","Missing required nonce field results in schema validation failure","Network or upstream Hyperliquid connectivity issues may return a 500 or timeout","Payment not provided or insufficient USDC results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to safely invalidate a Hyperliquid nonce as part of a cancellation or order management workflow without submitting a real trade. This is specifically for noop (no-operation) actions on Hyperliquid's L1 exchange, not for placing, modifying, or cancelling orders directly. Prefer this over cancel-order endpoints when your goal is purely nonce consumption for replay protection rather than actually cancelling a specific open order.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:36:03.851Z","isFirstParty":false,"canonicalSlug":"hyperliquid-noop-action-builder-nonce-invalidation-644aff54"}