# PerpCheck by YourAITools – Full Pre-Trade Hyperliquid Perp Validator

> PerpCheck by YourAITools – Full Pre-Trade Hyperliquid Perp Validator is a paid API for AI agents from api.youraitools.co, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-24).

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.

## Facts

- Endpoint: GET https://api.youraitools.co/perpcheck/v1/full?utm_source=zero.xyz
- Price: $0.01/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-full-pre-trade-hyperliquid-perp-validator-590645cf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eN3Oh5ulpjK5A-E22r3ZE

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-full-pre-trade-hyperliquid-perp-validator-590645cf
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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: 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": {
       
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/perpcheck-by-youraitools-full-pre-trade-hyperliquid-perp-validator-590645cf/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)