{"uid":"cap_JYhYsD97W5A00wQ93zcQ5","slug":"perpcheck-2628c222","name":"PerpCheck","description":"Pre-trade order check for Hyperliquid perps, for trading agents: will this order be rejected, and what does it cost and risk? Send coin, side, size or notional, optional limit price, leverage, cross/isolated and reduce-only. Returns REJECT_LIKELY / CAUTION / OK with each exchange-rule problem and a fix value (size decimals, price tick, $10 minimum, max leverage by margin tier, isolated-only, open-interest cap, delisted, far-from-mark limits), plus isolated liquidation estimate, taker impact from the live L2 book, funding carry per day and size vs 24 h volume. Read-only: never places, signs or holds orders. Fail-closed. Paid per call over x402 or prepaid credits; free preview and free remote MCP tier. Not financial advice; the exchange decides whether an order is accepted. Not financial advice; the exchange decides whether an order is accepted. PerpCheck is a read-only pre-trade check: it never places, signs or holds orders, has no custody and never asks for keys.","url":"https://perpcheck.agentgate.workers.dev/v1/full?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["coin","side"],"properties":{"coin":{"type":"string","description":"Hyperliquid main-dex perp name, e.g. BTC, ETH, SOL, HYPE, kPEPE"},"side":{"enum":["long","short","buy","sell"],"type":"string","description":"long/buy or short/sell"},"size":{"type":"string","description":"Order size in coins, exactly as you would send it (decimals are checked), e.g. 0.001. Give size or notional."},"price":{"type":"string","description":"Limit price exactly as you would send it (tick rule is checked). Omit for a market order (then taker impact is estimated from the L2 book)."},"margin":{"enum":["cross","isolated"],"type":"string","description":"cross (default) or isolated"},"leverage":{"type":"number","description":"Leverage, e.g. 10 (default 1)"},"notional":{"type":"number","description":"Order value in USD (instead of size), e.g. 100"},"reduceOnly":{"type":"boolean","description":"true if the order only reduces a position (exempt from the minimum and OI cap)"}},"description":"Search intents: liquidation price calculator, slippage estimate, hyperliquid pre trade, funding cost, perp order risk, market impact"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"coin":{"type":"string"},"side":{"type":"string"},"size":{"type":"number"},"tier":{"type":"string"},"rules":{"type":"object"},"issues":{"type":"array"},"margin":{"type":"string"},"market":{"type":"object"},"funding":{"type":"object"},"verdict":{"type":"string"},"leverage":{"type":"number"},"warnings":{"type":"array"},"execution":{"type":"object"},"checked_at":{"type":"string"},"confidence":{"type":"string"},"disclaimer":{"type":"string"},"order_type":{"type":"string"},"liquidation":{"type":"object"},"reduce_only":{"type":"boolean"},"notional_usd":{"type":"number"},"sources_failed":{"type":"array"}}}}}}},"responseSchema":{"type":"json","example":{"coin":"BTC","side":"long","size":0.001,"tier":"full","rules":{"szDecimals":5,"max_leverage":40,"only_isolated":false,"min_notional_usd":10,"price_max_decimals":1,"price_max_sig_figs":5,"max_leverage_at_size":40},"issues":[],"margin":"cross","market":{"mark":81274,"oracle":81279.6,"premium_bps":-0.69,"day_volume_usd":1978449099,"open_interest_usd":3634646602,"size_vs_day_volume_pct":0},"funding":{"apr_pct":10.95,"direction":"you pay","hourly_rate":0.0000125,"est_cost_per_day_usd":0.0244},"verdict":"OK","leverage":10,"warnings":[],"execution":{"mid":81274.5,"book_time":1792783206472,"spread_bps":0.12,"est_avg_fill":81275,"est_impact_bps":0.06,"book_depth_covered":1},"checked_at":"2026-10-23T19:20:07.089Z","confidence":"high","disclaimer":"Not financial advice; the exchange decides whether an order is accepted. PerpCheck is a read-only pre-trade check: it never places, signs or holds orders, has no custody and never asks for keys.","order_type":"market","liquidation":{"note":"cross margin: the real liquidation price depends on your whole account; this is the isolated-equivalent worst case","distance_pct":8.86,"estimate_isolated":74072.5},"reduce_only":false,"notional_usd":81.27,"sources_failed":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KLc0vHnIo2FeyR2mY-q4c","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Pre-trade validation for Hyperliquid perpetual futures orders: returns verdict (OK/CAUTION/REJECT_LIKELY) with rule violations, liquidation estimate, slippage, and funding cost","exampleAgentPrompt":"Before I place my order, check whether a 0.05 BTC long market order at 10x cross margin on Hyperliquid perps would be accepted — and tell me the liquidation estimate, expected slippage, and daily funding cost.","exampleUseCases":[{"title":"Validate perp order before submission","prompt":"I want to go long 0.1 ETH on Hyperliquid at a limit price of 3200, with 5x leverage in isolated margin — will the order get rejected, and what are the rule issues I need to fix?"},{"title":"Estimate liquidation price for leveraged position","prompt":"If I short 50 SOL on Hyperliquid with 20x cross margin, what's the estimated liquidation price and how far is that from the current mark?"},{"title":"Assess funding cost and slippage for large trade","prompt":"I'm thinking about opening a $50,000 notional long on HYPE perps at 3x leverage — what will the taker slippage and daily funding cost look like, and is there enough depth in the order book to fill it cleanly?"}],"resultDescription":"A JSON object with: a verdict field (OK, CAUTION, or REJECT_LIKELY); an issues array listing each exchange-rule problem with a fix value (e.g. correct size decimals, price tick, minimum notional, max leverage for the margin tier, OI cap breach, delisted coin, far-from-mark price); warnings array for non-blocking concerns; market data (mark price, oracle, premium bps, 24h volume, open interest); funding object (hourly rate, direction, estimated daily cost in USD); execution object (mid price, spread bps, estimated average fill, impact bps, book depth covered); liquidation estimate (isolated-equivalent distance and price); confidence level; and a disclaimer.","failureModes":["Unknown or delisted coin returns a REJECT_LIKELY verdict with 'delisted' rule issue","Missing required fields (coin, side) returns a 400-level error","L2 book unavailable causes sources_failed to list 'book' and execution estimates may be omitted","Hyperliquid API timeout may reduce confidence to 'low' or return partial results","Extremely small size below $10 notional triggers min_notional_usd rule issue","Price far from mark triggers far-from-mark rule violation in the issues array"],"whenToPreferThis":"Use PerpCheck when an AI trading agent needs to validate a Hyperliquid perpetual futures order before submission — especially to catch exchange-rule rejections (size decimals, price tick, minimum notional, max leverage by tier, OI caps), estimate liquidation risk, assess taker slippage from the live L2 book, and quantify daily funding carry. Prefer this over generic slippage calculators because it is Hyperliquid-specific, checks all exchange rules simultaneously, and returns structured fix values. It is read-only and has no custody or signing — safe to call speculatively.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:34:42.206Z","isFirstParty":false,"canonicalSlug":"perpcheck-2628c222"}