# Hyperliquid Perp Listing Status

> Hyperliquid Perp Listing Status is a paid API for AI agents from derivatives.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Checks whether a coin is listed as a live Hyperliquid perpetual, returning listing status (active, delisted, isolated-only), max leverage, and size precision.

## Facts

- Endpoint: GET https://derivatives.x402tookit.com/perp-listing?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-perp-listing-status-cdfcff58
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9dwDW6Q187hlhcoiMqpZK

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 hyperliquid-perp-listing-status-cdfcff58
```

Example prompt: Is PEPE currently listed as a Hyperliquid perp, and if so what's the max leverage and is it isolated-only?

## When to prefer this

Use this endpoint when you need to definitively confirm whether a specific coin is tradeable as a Hyperliquid perpetual before placing a trade or running a strategy, especially when you need to know leverage limits, size precision, or whether the coin is restricted to isolated margin. Prefer this over the full perp snapshot endpoint when listing status validation is the primary concern rather than price or funding data.

## Known failure modes

- Unknown or misspelled coin ticker returns a not-found or null verdict
- Hyperliquid API unavailable causes degraded=true response with partial or cached data
- Ticker format mismatch (e.g. omitting 'k' prefix for mini contracts) returns wrong coin data
- Rate limiting or payment failure returns 402 or error response

## How this service works

Is a coin a live Hyperliquid perp? Listed, delisted or isolated-only, with max leverage and size precision.

## Output

Returns a verdict on the coin's perp listing status (e.g. active, delisted, isolated-only), the maximum leverage allowed, the size precision in decimal places, a margin table ID, a human-readable summary with reasons, a source URL, a timestamp, and degraded-mode or disclaimer flags if data quality is reduced.

## 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"
     ],
     "properties": {
      "coin": {
       "type": "string",
       "description": "Ticker to check, e.g. PEPE, kPEPE, BTC"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "coin": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "sourceUrl": {
       "type": [
        "null",
        "string"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "isDelisted": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "maxLeverage": {
       "type": [
        "null",
        "number"
       ]
      },
      "onlyIsolated": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "sizeDecimals": {
       "type": [
        "null",
        "number"
       ]
      },
      "marginTableId": {
       "type": [
        "null",
        "number"
       ]
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-perp-listing-status-cdfcff58/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from derivatives.x402tookit.com](https://www.zero.xyz/host/derivatives.x402tookit.com/llms.txt)
