# Agent402 Perpetual Markets Data

> Agent402 Perpetual Markets Data is a paid API for AI agents from agent402.tools, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Returns live perpetual futures market data (price, funding, open interest, volume, leverage) from Hyperliquid, with optional coin filtering and sorting.

## Facts

- Endpoint: POST https://agent402.tools/api/perp-markets
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-perpetual-markets-data-cc1516b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pUd1klTP8ydpXcoUZMQfA

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 agent402-perpetual-markets-data-cc1516b8 -d '<json body>'
```

Example prompt: Pull the top 20 perp markets from Hyperliquid sorted by open interest, and filter it down to just BTC, ETH, and SOL — I want to see funding rates, mark price, and 24h volume.

## When to prefer this

Choose this endpoint when you need live perpetual futures market data — especially funding rates, open interest, and volume — from Hyperliquid without requiring an API key or account. It is ideal for agents monitoring DeFi derivatives markets, scanning for funding rate opportunities, or building dashboards over Hyperliquid perp data with flexible coin filtering and sorting.

## Known failure modes

- Invalid sort field returns an error or defaults to volume
- Invalid coin symbols in filter may return empty markets array
- Limit exceeding 500 may be capped or rejected
- Hyperliquid data source downtime causes fetch failure or stale data
- Malformed request body returns 400-level error

## How this service works

Every listed perpetual futures market in one call: mark, oracle and mid price, 24-hour change, funding (hourly, 8-hour, annualized), open interest in coins and dollars, 24-hour notional volume and max leverage, sortable by volume, open interest, funding or change. Use it as the one-shot market map before drilling into a single symbol.

## Output

A JSON object containing a list of perpetual market records sourced from Hyperliquid, each with coin symbol, mark price, oracle price, 8h funding rate, funding APR (annualized), hourly funding rate, premium percent, max leverage, 24h price change percent, open interest (raw and USD), and 24h volume in USD. Also includes total market count, sort field used, data source, and fetch timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "type": "string",
   "description": "volume (default), openInterest, funding, change, or coin."
  },
  "coins": {
   "type": "string",
   "description": "Optional comma-separated coin filter (e.g. \"BTC,ETH,SOL\")."
  },
  "limit": {
   "type": "number",
   "description": "Rows to return (default 50, max 500)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sort": "volume",
  "count": 2,
  "source": "hyperliquid",
  "markets": [
   {
    "coin": "BTC",
    "markPx": 77267,
    "oraclePx": 77236,
    "funding8h": 0.0001,
    "premiumPct": 0.0388,
    "maxLeverage": 40,
    "change24hPct": 0.39,
    "openInterest": 35935.67,
    "volume24hUsd": 4679441788.67,
    "fundingAprPct": 10.95,
    "fundingHourly": 0.0000125,
    "openInterestUsd": 2776803000
   }
  ],
  "fetchedAt": "2026-08-22T12:00:00.000Z",
  "totalMarkets": 230
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-perpetual-markets-data-cc1516b8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)