# x402stock Perpetual Futures Market Data

> x402stock Perpetual Futures Market Data is a paid API for AI agents from x402stock.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns live per-coin perpetual futures market data including mark/oracle prices, funding rates, open interest, and 24h volume for all active perp markets on Hyperliquid

## Facts

- Endpoint: GET https://x402stock.vercel.app/api/v1/perps
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-perpetual-futures-market-data-b5c91c5d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WkJlqJnz9f9cSfYD7FzqD

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 x402stock-perpetual-futures-market-data-b5c91c5d
```

Example prompt: Pull the live snapshot of all perpetual futures markets on Hyperliquid — I want to see funding rates, open interest, mark and oracle prices, and 24h volume for every coin in one shot.

## When to prefer this

Choose this endpoint when you need comprehensive perpetual futures data — especially funding rates and open interest — that is unavailable from spot market feeds. Ideal for derivatives traders, arbitrage monitors, and risk dashboards requiring live Hyperliquid perp state across all coins in a single call. Prefer over spot feeds when funding rate or leverage data is required, and over exchange-specific APIs when you want aggregated perp market state without managing exchange credentials.

## Known failure modes

- Hyperliquid API unavailability causes empty or stale data
- Rate limiting or upstream timeout returns 5xx error
- Payment of 0.02 USDC not processed results in 402 Payment Required
- Individual coin fields may be null if data is temporarily unavailable for that market
- Schema validation failure if upstream data format changes

## How this service works

Live state of every perpetual-futures market in one call: per coin the mark and oracle price, hourly funding rate with annualized APR, premium, open interest, max leverage, previous-day price, and 24h USD and base volume. Native crypto-derivatives data — funding and open interest are perp-only, absent from any spot feed. Free on-chain DEX data (venue: Hyperliquid), no key. From x402stock

## Output

A JSON object containing a timestamped snapshot of all perpetual futures markets on Hyperliquid, with per-coin fields including: coin ticker, mark price, oracle price, mid price, previous day close, hourly funding rate, annualized funding APR (%), premium, open interest, max leverage, 24h volume in USD, and 24h volume in base currency. Also includes top-level metadata: source, venue, market type, timestamp, and total market count.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "venue",
      "market",
      "count",
      "perps"
     ],
     "properties": {
      "as_of": {
       "type": "string"
      },
      "count": {
       "type": "number"
      },
      "perps": {
       "type": "array",
       "items": {
        "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": {
          "an
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-perpetual-futures-market-data-b5c91c5d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.vercel.app](https://www.zero.xyz/host/x402stock.vercel.app/llms.txt)
