# x402stock Perpetual Futures Overview

> x402stock Perpetual Futures Overview is a paid API for AI agents from agents.x402stock.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Returns a consolidated snapshot of a single on-chain perpetual futures market — mark price, oracle price, funding rate, open interest, recent funding history, L2 order book, and OHLCV candles — in one call.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/perps/overview/:coin
- Price: $0.03/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-overview-4af574f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-VkjkWydB6FZINJIIF8tz

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-overview-4af574f5
```

Example prompt: Give me the full perpetual futures overview for ETH on Hyperliquid — mark price, oracle price, current funding rate, open interest, recent funding history, the order book, and candle data, all in one shot.

## When to prefer this

Choose this endpoint when you need a full perpetual futures market snapshot for a single coin and want to avoid making four separate API calls (perps metadata, funding, order book, candles). Ideal for AI agents that need to reason about funding rates, open interest, price levels, and market microstructure simultaneously. Best suited for Hyperliquid on-chain DEX data specifically.

## Known failure modes

- Unknown or unsupported coin symbol returns an error or empty sections
- Hyperliquid DEX downtime may cause partial or full data unavailability
- Individual sections (order book, candles, funding) may degrade independently without failing the whole response
- Rate limiting or payment failure due to invalid USDC payment via x402 protocol

## How this service works

Everything about one on-chain perpetual-futures market in one call: live mark/oracle price with funding rate and open interest, recent funding history, the L2 order book, and OHLCV candles. Pass the coin in the path (e.g. BTC, ETH). Replaces four calls (perps/{coin} + funding + orderbook + candles) at a lower combined price. Free DEX data (venue: Hyperliquid). Sections degrade independently.

## Output

A single consolidated JSON response containing: live mark price and oracle price, current funding rate and open interest, recent funding rate history, L2 order book (bid/ask depth), and OHLCV candlestick data — all for the requested perpetual futures market on Hyperliquid. Sections degrade independently if a sub-source is unavailable.

## 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"
    },
    "pathParams": {
     "coin": {
      "type": "string"
     },
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-perpetual-futures-overview-4af574f5/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)