# Hyperliquid Market Search

> Hyperliquid Market Search is a paid API for AI agents from enchanted-oyster-554.convex.site, paid per call via x402, $0.050000/call, status unknown (last checked 2026-09-15).

Text-search Hyperliquid perpetual and spot markets by name (e.g. oil, copper, gold) across all perp DEXes or a specific one

## Facts

- Endpoint: POST https://enchanted-oyster-554.convex.site/x402/tools/searchHyperliquidMarkets
- Price: $0.050000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-market-search-406fcd86
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TvFfA0ZpVSxS5H0l3MhoZ

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-market-search-406fcd86 -d '<json body>'
```

Example prompt: Search Hyperliquid perp and spot markets for 'gold' and return up to 20 results so I can see what gold-related markets are available.

## When to prefer this

Use this endpoint when you need to discover or confirm which Hyperliquid perpetual or spot markets exist for a given asset name before trading, monitoring, or analysis. Prefer this over hardcoding market names, especially for commodity or non-standard asset searches. Best suited for pre-trade discovery flows on Hyperliquid DEXes.

## Known failure modes

- Empty result set if no markets match the query string
- Query string too long (>64 chars) causes validation error
- Limit out of range (<1 or >100) causes validation error
- DEX name not recognized returns empty or error
- Network or Convex backend unavailability returns 5xx
- Payment failure (x402) if USDC not provided or insufficient

## How this service works

Text-search Hyperliquid perp and spot markets by name (e.g. oil, copper, purr) across all perp dexes unless dex is set. Returns human-readable name/coin plus exchange assetId and spotPairId for each hit. Read-only.

## Output

A list of matching Hyperliquid markets (perp and/or spot) that contain the search query in their name, including market metadata such as market name and DEX. Results are filtered based on query string, market type inclusion flags, and optional DEX scope, up to the specified limit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "inputSchema"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "dex": {
       "type": "string",
       "maxLength": 32
      },
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1
      },
      "query": {
       "type": "string",
       "maxLength": 64,
       "minLength": 1
      },
      "includePerp": {
       "type": "boolean"
      },
      "includeSpot": {
       "type": "boolean"
      }
     },
     "additionalProperties": true
    },
    "description": {
     "type": "string"
    },
    "inputSchema": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "query"
     ],
     "properties": {
      "dex": {
       "type": "string",
       "maxLength": 32
      },
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1
      },
      "query": {
       "type": "string",
       "maxLength": 64,
       "minLength": 1
      },
      "includePerp": {
       "type": "boolean"
      },
      "includeSpot": {
       "type": "boolean"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": true
  },
  "output": {
   "type": "object",
   "additionalProperties": true
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-market-search-406fcd86/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from enchanted-oyster-554.convex.site](https://www.zero.xyz/host/enchanted-oyster-554.convex.site/llms.txt)