{"uid":"cap_K9L-cWUdK_xvtxdD8PJAS","slug":"agent-weather-models-category-report-5766713f","name":"Agent Weather Models Category Report","description":"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.\n\nPay 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.\n\n**Payment flow**\n1. Call the paid endpoint without payment and receive **402** with a `PAYMENT-REQUIRED` header\n   (base64 of the same JSON as the body). Each 402 mints a fresh single-use `extra.invoiceId`.\n2. Choose an `accepts[]` entry: RLUSD on XRPL (sign an XRPL `Payment` bound to that invoice) or, where offered,\n   USDC on Base (sign an EIP-3009 authorization), and retry with the base64 x402 `PaymentPayload` in `PAYMENT-SIGNATURE`.\n3. The server verifies and settles through the facilitator and re-checks the transaction on-ledger.\n   It then returns **200** with the report and a `PAYMENT-RESPONSE` header.\n\nSettlement uses the T54 XRPL mainnet facilitator (`https://xrpl-facilitator-mainnet.t54.ai`) for RLUSD and the CDP facilitator for USDC on Base.\nUse the `x402-xrpl` client (npm/PyPI). The reference `@x402/xrpl` client currently can't pay through\nT54 (https://github.com/x402-foundation/x402/issues/3527).\n\nThe live `/.well-known/x402` catalog is the source of truth for prices.\n\n\nFor 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.","url":"https://api.agentweather.io/v1/models/category/%7Bname%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"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":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rZo0UlDo8ACgHr-AZFyMm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a category-filtered report of OpenRouter AI models including pricing, status, vendor health, and recent changes for a named model category","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Cheapest image generation model selection","prompt":"Can you get the Agent Weather report for image-output models and tell me which ones are cheapest right now, and whether any vendors are having issues?"},{"title":"Monitoring new model launches in a category","prompt":"Check Agent Weather for the text-generation model category and let me know if any new models have been added in the last 7 days and if there have been any price changes."},{"title":"Vendor health check for a model category","prompt":"Pull the Agent Weather category conditions report for coding models — I need to know which vendors are operational, which are unknown status, and if there are any disturbances right now."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:36:39.163Z","isFirstParty":false,"canonicalSlug":"agent-weather-models-category-report-5766713f"}