# Agent Weather Models Category Report

> Agent Weather Models Category Report is a paid API for AI agents from api.agentweather.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-18).

Returns a category-filtered report of OpenRouter AI models including pricing, status, vendor health, and recent changes for a named model category

## Facts

- Endpoint: GET https://api.agentweather.io/v1/models/category/%7Bname%7D?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-weather-models-category-report-5766713f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K9L-cWUdK_xvtxdD8PJAS

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 agent-weather-models-category-report-5766713f
```

Example prompt: Pull the Agent Weather category report for image-output models — I want to see how many are available, which vendors are operational, any price changes in the last 24 hours, and which ones are newly listed this week.

## When to prefer this

Choose this endpoint when you need a comprehensive snapshot of all AI models within a specific category (e.g. image-output, text, coding) including vendor health, pricing trends, new arrivals, and disturbances in a single call. Prefer it over generic model listing APIs when you need structured change-tracking (price moves, new models, expirations) and vendor operational status combined. Use it when building agent decision logic that needs to select or rank models within a category based on cost and availability.

## Known failure modes

- 402 Payment Required if x402 payment not included — returns PAYMENT-REQUIRED header with invoice details
- Unknown or misspelled category name may return empty model list or error
- Category with no matching models returns zero counts
- OpenRouter data source temporarily unavailable may cause gaps reported in disturbances.vendors_status_unknown
- Stale data if upstream OpenRouter API is slow or unresponsive

## How this service works

AI provider health readings and a combined record for AI agents, each reading with its source and timestamp. `/v1/decide/provider-health` returns one AI provider's status-page reading plus its last 24h in our record; `/v1/agent-weather/current` returns the combined record in one call (AI provider health, x402 payment activity on the XRP Ledger, agent tooling). For XRP Ledger users: x402 merchant readings by XRPL address at `/v1/merchant/{address}`. OpenRouter model price readings: `/v1/models/report` and `/v1/decide/cheapest-model`. Raw readings first; gaps are reported, not filled.

Pay per request with [x402](https://x402.org) v2 (scheme `exact`): RLUSD on the XRP Ledger (`xrpl:0`) or USDC on Base (`eip155:8453`), same price on every paid route. No API key or account.

**Payment flow**
1. Call the paid endpoint without payment and receive **402** with a `PAYMENT-REQUIRED` header
   (base64 of the same JSON as the body). Each 402 mints a fresh single-use `extra.invoiceId`.
2. Choose an `accepts[]` entry: RLUSD on XRPL (sign an XRPL `Payment` bound to that invoice) or, where offered,
   USDC on Base (sign an EIP-3009 authorization), and retry with the base64 x402 `PaymentPayload` in `PAYMENT-SIGNATURE`.
3. The server verifies and settles through the facilitator and re-checks the transaction on-ledger.
   It then returns **200** with the report and a `PAYMENT-RESPONSE` header.

Settlement uses the T54 XRPL mainnet facilitator (`https://xrpl-facilitator-mainnet.t54.ai`) for RLUSD and the CDP facilitator for USDC on Base.
Use the `x402-xrpl` client (npm/PyPI). The reference `@x402/xrpl` client currently can't pay through
T54 (https://github.com/x402-foundation/x402/issues/3527).

The live `/.well-known/x402` catalog is the source of truth for prices.


For a free format preview, GET `/v1/sample/yesterday`; it returns the latest stored snapshot at least 24 hours old, with no payment required, and is cached hourly.

## Output

A structured category conditions report containing: list of models with IDs, names, vendor, context length, input/output modalities, pricing per 1M tokens, standard job cost estimate, expiration dates, and status; aggregate counts of models, vendors, new additions in 24h/7d, price changes in 24h, expiring models; disturbance records including current issues and vendor status unknowns; list of price movers and retiring models; source provenance with URLs and observed timestamps; report ID and issuance timestamp.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "kind": "category conditions report",
  "rule": "`architecture.output_modalities` contains \"image\"",
  "sort": {
   "by": "id (alphabetical)",
   "options": "?sort=cost to order by standard_job_cost_usd"
  },
  "counts": {
   "models": 12,
   "new_7d": 0,
   "new_24h": 0,
   "vendors": 3,
   "removed_7d": 0,
   "price_changes_24h": 0,
   "expiring_within_60d": 0,
   "with_expiration_date": 0,
   "vendors_disturbed_now": 1,
   "variable_price_entries": 2,
   "vendors_status_unknown": 1
  },
  "models": [
   {
    "id": "google/gemini-2.5-flash-image",
    "name": "Google: Nano Banana (Gemini 2.5 Flash Image)",
    "status": "operational",
    "vendor": "google",
    "context_length": 32768,
    "expiration_date": null,
    "input_modalities": [],
    "output_modalities": [],
    "price_in_usd_per_1m": 0.3,
    "price_out_usd_per_1m": 2.5,
    "standard_job_cost_usd": 0.0055
   }
  ],
  "sources": [
   {
    "url": "https://openrouter.ai/api/v1/models",
    "name": "OpenRouter public model list (no key)",
    "observed_at": "2026-10-12T02:21:05.825Z"
   }
  ],
  "summary": "image-output: 12 models from 3 vendors; 0 price change(s) in 24h; 0 new in 24h,…",
  "category": "image-output",
  "issued_at": "2026-10-12T02:34:12.750Z",
  "report_id": "awmc-20261012T0234Z-image-output",
  "new_models": {
   "note": "models already listed when collection began are not counted as new",
   "last_7d": [],
   "last_24h": [],
   "observed_since": "2026-10-07T13:39:34.249Z"
  },
  "disturbances": {
   "now": [
    {}
   ],
   "status_changes_24h": [],
   "vendors_status_unknown": [
    "openrouter"
   ]
  },
  "example_data": false,
  "schema_version": "model-conditions-0.1.0-draft",
  "retiring_models": [],
  "price_movers_24h": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-weather-models-category-report-5766713f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentweather.io](https://www.zero.xyz/host/api.agentweather.io/llms.txt)