Back to Browse
PerpCheck – Hyperliquid Pre-Trade Order Validator
x402
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.
Price / call$0.003
Success—
StatusUnknown
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.
Example use cases
Trading bot safety gate
“My bot is about to submit a short order for 0.001 BTC at $68,000 limit price with 20x leverage in isolated margin on Hyperliquid — run a pre-trade check and tell me if it will be rejected and what to fix.”
Sizing a minimum viable position
“I want to open a long on kPEPE worth about $15 notional using cross margin at 5x leverage — will that meet Hyperliquid's minimum order requirements, or do I need to adjust?”
Validating aggressive leverage before submission
“Check whether a short on HYPE using 60x leverage and isolated margin with a size of 10 coins will be accepted by Hyperliquid, and tell me the maximum leverage allowed at that position size.”
Technical details
Endpoint
GEThttps://perpcheck.agentgate.workers.dev/v1/lite?utm_source=zero.xyzWhen to prefer
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.
Side effects
- 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
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"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": []
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"