{"uid":"cap_eN3Oh5ulpjK5A-E22r3ZE","slug":"perpcheck-by-youraitools-full-pre-trade-hyperliquid-perp-validator-590645cf","name":"PerpCheck by YourAITools – Full Pre-Trade Hyperliquid Perp Validator","description":"Hyperliquid pre-trade risk check API. Full pre-trade check of a Hyperliquid perp order: everything in lite (verdict, rule issues with fixes) plus the isolated liquidation price and distance, taker impact and average fill from the live L2 book for market orders, funding carry per day (who pays), mark/oracle premium, open interest and size vs 24 h volume. Read-only; never places or signs orders. Fail-closed. Not financial advice; the exchange decides whether an order is accepted.","url":"https://api.youraitools.co/perpcheck/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_7hWoTfM-TmWq89pZKrUT_","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":"Validates a Hyperliquid perpetual futures order before submission, returning a REJECT_LIKELY/CAUTION/OK verdict with sizing rules, funding cost estimates, liquidation estimates, and execution impact analysis.","exampleAgentPrompt":"Before I place it, can you run a pre-trade check on a BTC long on Hyperliquid — market order for 0.001 BTC, 10x leverage, cross margin — and tell me if it'll likely be accepted, what the funding cost looks like, and my estimated liquidation price?","exampleUseCases":[{"title":"Validate leveraged ETH short before placing","prompt":"I want to short ETH on Hyperliquid with 5x leverage and a notional of $500 using cross margin — can you run a pre-trade check and tell me if the order is likely to be accepted, what the spread looks like, and what my estimated liquidation price would be?"},{"title":"Check funding cost before holding long position","prompt":"I'm thinking of going long SOL on Hyperliquid, isolated margin, 3x leverage, size 2 SOL — can you check the current funding rate, tell me what it'll cost me per day, and flag any issues with my order parameters?"},{"title":"Verify limit order tick size and minimum notional","prompt":"Can you validate a limit long order on kPEPE on Hyperliquid — I want to buy at 0.00001234 with a notional of $50, cross margin, 1x leverage — and check if my price respects tick rules and whether I meet the minimum notional?"}],"resultDescription":"Returns a JSON object with a top-level verdict (OK, CAUTION, or REJECT_LIKELY), lists of issues and warnings, current market data (mark price, oracle price, funding rate with APR and daily cost estimate, open interest, volume), execution impact (spread bps, estimated avg fill, book depth covered), liquidation price estimate with distance percentage, and all applicable exchange rules (size decimals, max leverage, min notional, price tick constraints). Also includes confidence level and a disclaimer that no order is placed.","failureModes":["Unknown or delisted coin ticker returns an error or sources_failed entry","Invalid side value (not long/short/buy/sell) causes input validation rejection","Providing both size and notional may cause ambiguity or error","Price violating tick rules surfaces as an issue in the issues array","Network or exchange data unavailability may reduce confidence or populate sources_failed","Missing required fields (coin or side) returns a schema validation error"],"whenToPreferThis":"Use this endpoint when an AI agent or user needs to validate a Hyperliquid perpetual futures order before submitting it — especially to catch REJECT_LIKELY scenarios (bad tick size, below minimum notional, leverage exceeded), estimate real-time funding costs, or assess liquidation risk. Prefer this over generic market data endpoints when you need the combined pre-trade ruleset check plus execution impact for Hyperliquid specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T12:30:11.300Z","isFirstParty":false,"canonicalSlug":"perpcheck-by-youraitools-full-pre-trade-hyperliquid-perp-validator-590645cf"}