# PerpCheck – Hyperliquid Pre-Trade Order Validator

> PerpCheck – Hyperliquid Pre-Trade Order Validator is a paid API for AI agents from perpcheck.agentgate.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-31).

Validates a proposed Hyperliquid perpetuals order against exchange rules before submission, returning a REJECT_LIKELY/CAUTION/OK verdict with specific rule violations and fix suggestions.

## Facts

- Endpoint: GET https://perpcheck.agentgate.workers.dev/v1/lite?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/perpcheck-hyperliquid-pre-trade-order-validator-5b866e7d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kr4-znGEAOqRLOxh0loRa

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-hyperliquid-pre-trade-order-validator-5b866e7d
```

Example prompt: Before I send this trade, check if a long order for 0.05 ETH at a limit price of $3000.10 with 10x leverage in cross margin on Hyperliquid will be accepted — tell me the verdict and any rule violations I need to fix.

## When to prefer this

Use this endpoint when a trading agent or bot needs to pre-validate a Hyperliquid perpetuals order before submission to avoid on-chain rejections. It is the only purpose-built, read-only pre-trade checker for Hyperliquid that covers all major rejection causes (size decimals, price tick, minimum notional, max leverage by tier, OI cap, isolated-only coins, delisted assets, far-from-mark limits) in a single call, with live L2 book data for market impact and liquidation estimates.

## Known failure modes

- Unknown coin symbol returns error or low-confidence result
- Hyperliquid API unavailable causes sources_failed list to populate and confidence to degrade
- Missing required query params (coin or side) returns 400-level error
- Truncated response if the exchange metadata feed is stale
- Rate limiting or payment failure (x402) if credits exhausted

## How this service works

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.

## Output

A JSON object with a top-level verdict (REJECT_LIKELY, CAUTION, or OK), an array of issues each containing a rule violation code, human-readable message, and suggested fix value, plus warnings (e.g. marketable limit), exchange rules for the coin (szDecimals, max_leverage, min_notional, price_max_decimals), estimated notional in USD, margin mode, leverage, order type, confidence level, and a disclaimer. Also includes taker impact from the live L2 book, funding carry, and size vs 24h volume when available.

## 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-hyperliquid-pre-trade-order-validator-5b866e7d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from perpcheck.agentgate.workers.dev](https://www.zero.xyz/host/perpcheck.agentgate.workers.dev/llms.txt)