# PerpCheck by YourAITools > PerpCheck by YourAITools is a paid API for AI agents from api.youraitools.co, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-24). Pre-trade validation of a Hyperliquid perpetuals order, returning REJECT_LIKELY / CAUTION / OK with specific rule violations and fix values ## Facts - Endpoint: GET https://api.youraitools.co/perpcheck/v1/lite?utm_source=zero.xyz - Price: $0.003/call - Payment: x402 - Status: unknown - Last checked: 2026-10-24 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/perpcheck-by-youraitools-4ad57171 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wkLKkw5-pDeCtqQ6pxHVk Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability perpcheck-by-youraitools-4ad57171 ``` Example prompt: Before I place it, can you run a pre-trade check on a long ETH perp order on Hyperliquid — size 0.05 ETH, limit price 3200.50, using cross margin at 10x leverage? ## When to prefer this Use this endpoint when an AI agent needs to validate a Hyperliquid perpetuals order before submission — especially to catch size decimal mismatches, price tick violations, minimum notional breaches, leverage tier limits, isolated-only restrictions, OI caps, or delisted coins. It is read-only and fail-closed, making it safe to call in any automated trading workflow without risk of placing an order. Prefer it over generic exchange rule lookups when you need a per-order verdict with actionable fix values rather than just static rule documentation. ## Known failure modes - Coin not found or delisted — verdict includes a 'delisted' issue code - Source data unavailable — sources_failed is populated and verdict is never OK (fail-closed) - Invalid enum for side or margin — request rejected with schema validation error - Price or size provided as non-numeric string — parsing error returned - Network timeout fetching Hyperliquid L2 book for market order estimation ## How this service works Hyperliquid order checker API (pre-trade). Pre-trade check of a Hyperliquid perp order before you send it: REJECT_LIKELY / CAUTION / OK, each exchange-rule issue with a fix value (size decimals, price tick, $10 minimum, max leverage by margin tier, isolated-only, OI cap, delisted, far-from-mark limit), warnings and the coin rules. Read-only; never places or signs orders. Fail-closed: a failed source is listed, never OK. Not financial advice; the exchange decides whether an order is accepted. ## Output A JSON object with a verdict field (REJECT_LIKELY, CAUTION, or OK), an issues array each containing a code, human-readable message, and a suggested fix value, a warnings array for non-fatal concerns (e.g. marketable limit), the full coin rules (szDecimals, max_leverage, min_notional_usd, price tick), confidence level, a list of any data sources that failed, and a disclaimer confirming no order was placed. ## Request schema (JSON Schema) ```json { "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: hyperliquid order check, pre trade check, perp order validation, order size tick check, trading bot safety, hyperliquid rules" } }, "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": … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "coin": "ETH", "side": "long", "size": 0.0012, "tier": "lite", "rules": { "szDecimals": 4, "max_leverage": 25, "only_isolated": false, "min_notional_usd": 10, "price_max_decimals": 2, "price_max_sig_figs": 5, "max_leverage_at_size": 25 }, "issues": [ { "msg": "order value $3.70 is below Hyperliquid's $10 minimum", "code": "min_notional" }, { "fix": 0.0012, "msg": "size has 7 decimals; this coin allows 4 (szDecimals)", "code": "size_decimals" }, { "fix": 3000.1, "msg": "price has 3 decimals; max for this coin is 2", "code": "price_tick" }, { "fix": 25, "msg": "leverage 60x is above the 25x maximum for this coin at $4 notional", "code": "leverage" } ], "margin": "cross", "verdict": "REJECT_LIKELY", "leverage": 60, "warnings": [ { "msg": "limit buy above mark by 25.37%: fills immediately as taker", "code": "marketable_limit" } ], "checked_at": "2026-10-23T19:20:07.798Z", "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": "limit", "reduce_only": false, "notional_usd": 3.7, "sources_failed": [] } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/perpcheck-by-youraitools-4ad57171/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.youraitools.co](https://www.zero.xyz/host/api.youraitools.co/llms.txt)