# Annalist HIP-3 Market Data

> Annalist HIP-3 Market Data is a paid API for AI agents from api.annalist.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-14).

Returns aggregated Hyperliquid perpetuals market data including open interest and exchange breakdowns, signed for AI agent use and paid per call via x402.

## Facts

- Endpoint: GET https://api.annalist.dev/v1/hip3/market?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/annalist-hip-3-market-data-9791edea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JT2-jl0ogUOIhPJQHGMSc

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 annalist-hip-3-market-data-9791edea
```

Example prompt: Pull the current Hyperliquid market summary — I want to know how many perp markets are live and what the open interest breakdown looks like across exchanges.

## When to prefer this

Choose this endpoint when you need verified, signed aggregate market data for Hyperliquid perpetuals — especially when your agent pipeline requires cryptographically attested data or when you need open interest aggregated by exchange. Prefer over generic market data APIs when operating in an x402 micropayment context or when data provenance/signing is required for downstream trust.

## Known failure modes

- Payment not included or insufficient — returns HTTP 402 requiring x402 payment
- Invalid or unrecognized 'properties' filter — may return empty or default market set
- Hyperliquid upstream data unavailable — service may return 503 or stale data
- Malformed request parameters — returns 400 bad request

## How this service works

Signed data for AI agents, paid per call over x402. Hyperliquid crowd state, smart money and liquidations with what historically happened next, plus independent checks of x402 services and MCP servers.

## Output

A JSON object containing the total number of markets (e.g. 160), and an array of exchange-level breakdowns each with the exchange name, number of markets listed, and open interest in USD. Data is cryptographically signed by Annalist for agent-verifiable provenance.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "markets": 160,
   "exchanges": [
    {
     "markets": 114,
     "exchange": "xyz",
     "open_interest_usd": 3776000000
    }
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/annalist-hip-3-market-data-9791edea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.annalist.dev](https://www.zero.xyz/host/api.annalist.dev/llms.txt)