# Hyperliquid Perpetual Futures Market State by Coin

> Hyperliquid Perpetual Futures Market State by Coin is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.01/call, status unknown (last checked 2026-09-14).

Returns live perpetual-futures market data for a single coin on Hyperliquid DEX, including mark/oracle price, funding rate, open interest, volume, and max leverage.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/perps/{coin}
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-hyperliquid-perpetual-futures-market-state-by-coin-28d753fc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Z9bDA5wmfQndkvpVorKAF

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 agents-x402stock-xyz-hyperliquid-perpetual-futures-market-state-by-coin-28d753fc
```

Example prompt: What's the current funding rate and open interest for BTC perpetual futures on Hyperliquid right now, including the annualized APR?

## When to prefer this

Use this endpoint when you need real-time perpetual futures market state for a specific coin on Hyperliquid, especially for funding rate signals, open interest analysis, or mark/oracle price divergence monitoring. It is the fastest single-coin read for on-chain perp data without requiring an API key. Prefer this over generic crypto price endpoints when funding rate, open interest, or leverage data is required. Best suited for agents doing DeFi strategy evaluation, carry trade monitoring, or liquidation risk assessment on Hyperliquid.

## Known failure modes

- Invalid or unsupported coin symbol returns an error — only coins listed on Hyperliquid perpetuals are valid
- Hyperliquid DEX downtime or API unavailability may result in stale or missing data
- Some fields (mark_price, oracle_price, funding_rate_hourly, etc.) may be null if the market is inactive or data is temporarily unavailable
- Payment failure via x402 (insufficient USDC balance) prevents the request from completing

## How this service works

Live state of one perpetual-futures market by coin (e.g. BTC, ETH, SOL): mark and oracle price, current hourly funding rate with annualized APR, premium, open interest, max leverage, previous-day price, and 24h USD and base volume. The single-coin read for funding and open-interest signals. Free on-chain DEX data (venue: Hyperliquid), no key. From x402stock

## Output

A JSON object containing the coin symbol, mark price, oracle price, mid price, previous day price, hourly funding rate, annualized funding APR, premium, open interest, max leverage, 24h USD volume, 24h base volume, the venue (Hyperliquid), market type (perp), and a timestamp for when the data was fetched.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "coin"
 ],
 "properties": {
  "coin": {
   "type": "string",
   "description": "Hyperliquid perpetual coin symbol, e.g. BTC or ETH."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "venue",
  "market",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "coin",
    "max_leverage",
    "mark_price",
    "oracle_price",
    "mid_price",
    "prev_day_price",
    "funding_rate_hourly",
    "funding_apr_percent",
    "premium",
    "open_interest",
    "day_volume_usd",
    "day_volume_base"
   ],
   "properties": {
    "coin": {
     "type": "string"
    },
    "premium": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "mid_price": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "mark_price": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "max_leverage": {
     "type": "number"
    },
    "oracle_price": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "open_interest": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "day_volume_usd": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "prev_day_price": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "day_volume_base": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "funding_apr_percent": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "funding_rate_hourly": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    }
   },
   "additionalProperties": false
  },
  "as_of": {
   "type": "string"
  },
  "venue": {
   "type": "string"
  },
  "market": {
   "type": "string",
   "const": "perp"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-hyperliquid-perpetual-futures-market-state-by-coin-28d753fc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)