# Annalist Price Benchmarks

> Annalist Price Benchmarks is a paid API for AI agents from api.annalist.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-14).

Returns statistical price benchmarks (P25, median, P75) for x402-paid API services in a given category, with an optional price-check verdict showing where a specific price falls relative to peers.

## Facts

- Endpoint: GET https://api.annalist.dev/v1/prices/benchmarks?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/annalist-price-benchmarks-3037d663
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9Bfd0Oi3w06QSI7ZwAu7k

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-price-benchmarks-3037d663
```

Example prompt: What are the price benchmarks for x402 search APIs, and is 0.02 USDC above or below the median for that category?

## When to prefer this

Use this endpoint when you need to benchmark or validate x402 API pricing against real market data — particularly when deciding how to price your own service, evaluate cost-competitiveness of a tool, or understand the distribution of prices in a specific service category. It is the only known source of aggregated, signed, per-category price statistics for the x402 ecosystem.

## Known failure modes

- Unknown or misspelled tag returns empty or null data
- Price parameter not parseable as a valid USDC decimal causes error
- Missing required query params returns schema validation error
- Payment failure via x402 results in 402 response before data is returned

## 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 category tag, total service count, price distribution statistics (P25, median, P75 in USDC), and optionally a price check object with a plain-language verdict (e.g. 'above the median'), exact percentile ranking, and the queried price.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "tag": {
       "type": "string",
       "description": "category, for example search, llm, weather"
      },
      "price": {
       "type": "string",
       "description": "a price in USDC to place within the category, for example 0.02"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "tag": "search",
   "services": 88,
   "price_usdc": {
    "p25": 0.0035,
    "p75": 0.02,
    "median": 0.0095
   },
   "price_check": {
    "verdict": "above the median",
    "percentile": 0.74,
    "price_usdc": 0.02
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/annalist-price-benchmarks-3037d663/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)