# Annalist API Contract Monitor

> Annalist API Contract Monitor is a paid API for AI agents from api.annalist.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-21).

Returns the current contract record for a watched public API: version, operation count, deprecated operations, security schemes, and all breaking changes in the last 90 days, read daily from the provider's published OpenAPI spec.

## Facts

- Endpoint: GET https://api.annalist.dev/v1/apis/api?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/annalist-api-contract-monitor-ce6211d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZXhERCa4pLg1DfmaqgTVk

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-api-contract-monitor-ce6211d4
```

Example prompt: Pull the current contract record for the Stripe API from Annalist — I want to see the version, operation count, any deprecated operations, and all breaking changes from the last 90 days.

## When to prefer this

Use this endpoint when you need authoritative, daily-refreshed contract data for a well-known public API — including deprecation status, breaking change history, and security scheme details — sourced directly from the provider's published OpenAPI spec. Prefer this over manually fetching and diffing OpenAPI specs when you need a signed, structured changelog rather than raw spec files.

## Known failure modes

- API name not found in the watched list — returns empty or error indicating the API is not monitored
- API provider's OpenAPI spec temporarily unavailable — stale or missing data for recent days
- Malformed name parameter — may return a 400 or empty result
- Payment failure via x402 — call not executed if USDC payment cannot be processed

## How this service works

One watched public API's contract record: current version, operation count and keys, deprecated operations, security schemes, and every dated change in the last 90 days with what broke. From the provider's published OpenAPI description, read daily. Without name=, lists the APIs we watch. Signed.

## Output

A signed JSON record containing the API's current OpenAPI version, total operation count, list of deprecated operations, active security schemes, and a dated changelog of all changes (including breaking changes) observed in the past 90 days. If no name parameter is provided, returns the list of all APIs currently monitored by Annalist.

## 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": {
      "name": {
       "type": "string",
       "description": "the API, for example stripe, github, openai"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/annalist-api-contract-monitor-ce6211d4/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)
