{"uid":"cap_-oduycjpvLxU0unaO_iyO","slug":"pricing-state-api-pricing-change-history-9b62cdf6","name":"Pricing State API — Pricing Change History","description":"$0.01 USDC required (x402 / Base)\n\nReturns the history of detected pricing changes: what changed, plan-level detail, and when each change was detected.\n\nNo API key needed. Pay with any x402-compatible wallet that holds USDC on Base. If your agent does not yet have a funded wallet, set one up via Coinbase Agentic Wallet or Base MCP — then standard x402 clients will pay and retry automatically.","url":"https://pricing-state-api.replit.app/api/monitors/:slug/changes?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"},"pathParams":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string","example":"linear","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"One monitor slug from the free catalog at GET /api/monitors — not the only paid monitor; every enabled slug in the catalog is a paid resource. The path template itself is a placeholder, not a vendor."}}},"queryParams":{"type":"object","required":[],"properties":{"limit":{"type":"integer","default":20,"example":20,"maximum":100,"minimum":1,"description":"Maximum number of change records to return, most recent first (optional)."},"before":{"type":"string","pattern":"^[A-Za-z0-9_-]{8,128}$","description":"Opaque cursor from a previous response's nextBefore, to fetch the page of older records (optional). Construct nothing here: pass back exactly what the last response returned. Omit it for the newest page."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_EQCwYFszBNYQtIUR7q8-R","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the detected history of pricing changes for a monitored SaaS product, including what changed, plan-level detail, and when each change was detected.","exampleAgentPrompt":"Pull up the full pricing change history for Notion from the Pricing State API — I want to see every plan-level change that was detected and when.","exampleUseCases":[{"title":"SaaS pricing audit for procurement","prompt":"Can you check the pricing history for Linear? I want to know if their pricing has gone up recently before we commit to a plan."},{"title":"Competitive pricing intelligence tracking","prompt":"Show me every pricing change detected for Notion over time — I need to build a timeline of when they adjusted their plan prices."},{"title":"Budget alert for recurring SaaS subscriptions","prompt":"Pull the pricing change log for our monitored tools — specifically any plan-level price changes that happened in the last few months so I can flag them for the finance team."}],"resultDescription":"A structured list of historical pricing changes for the specified monitored SaaS product, including which plans changed, the nature of each change (e.g. price increase, plan addition/removal), and the timestamp when each change was detected.","failureModes":["Invalid or unrecognized slug returns an error or empty result","Insufficient USDC balance causes payment failure and no data returned","Slug for a product not yet being monitored returns no history","Network or service downtime on the Replit-hosted API returns a 5xx error"],"whenToPreferThis":"Choose this endpoint when you need historical pricing change data for a specific SaaS product — not just current pricing — and want to see a timestamped log of every detected change at the plan level. Prefer this over the current-pricing endpoint when your goal is trend analysis, competitive pricing audits, or alerting on past changes rather than retrieving a snapshot of today's prices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:38:22.192Z","isFirstParty":false,"canonicalSlug":"pricing-state-api-pricing-change-history-9b62cdf6"}