{"uid":"cap_DdzUVb9CByEwUmywo6Auc","slug":"prereason-change-events-feed-d218827c","name":"PreReason Change Events Feed","description":"What changed since your last read: one page of PreReason's change events after a cursor. A briefing's state label, a tracked release, and, for the companies you name (?companies=, at most 200), newer figures, a situation turning on or filed news (?kinds= narrows it). Each event says what changed, when it happened, when PreReason knew it and where to fetch it, never a value. With no cursor it answers the last 24 hours; each answer's next_cursor is where the next read starts.","url":"https://api.prereason.com/api/events?utm_source=zero.xyz","method":"GET","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"},"queryParams":{"type":"object","properties":{"kinds":{"type":"string","description":"Company news kinds, comma separated, from earnings-release, material-event, leadership-change, ownership-report. Left out, every kind but ownership-report, which comes only when named."},"limit":{"type":"string","pattern":"^[0-9]{1,3}$","description":"Events a page holds, 1 to 100. Default 50."},"types":{"type":"string","description":"Event types, comma separated, from state.changed, release.published, company.figures_updated, company.situation_changed, company.news. Every type when left out."},"cursor":{"type":"string","pattern":"^[0-9]{1,18}$","description":"The next_cursor of your previous read. Left out, the read starts 24 hours back."},"companies":{"type":"string","description":"Company addresses, comma separated, at most 200. A company's events reach only a read that names it."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"events":[],"has_more":false,"next_cursor":"0"}},"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_gGZXFDk_u79ofcMO_J0yf","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 paginated page of change events (briefing state changes, release publications, company figure updates, news) since a given cursor, optionally filtered by company addresses, event types, and news kinds.","exampleAgentPrompt":"Check PreReason for any new events since my last cursor 1718000000 — earnings releases, leadership changes, and material events — for these companies: 0xABC123, 0xDEF456, limit 50 results.","exampleUseCases":[{"title":"Earnings release alert for watchlist","prompt":"Pull any new earnings-release or material-event updates from PreReason for my company watchlist — addresses 0xABC123, 0xDEF456, 0xGHI789 — since cursor 1718500000, limit 25."},{"title":"Morning briefing state change digest","prompt":"Give me all state.changed and release.published events from PreReason since my last cursor 1718900000 so I can see which briefings changed status overnight."},{"title":"Leadership change monitoring","prompt":"Check PreReason for any leadership-change or ownership-report events for these 5 companies — 0x111, 0x222, 0x333, 0x444, 0x555 — starting from cursor 1719000000, and show me everything up to 100 results."}],"resultDescription":"Returns a JSON object with an array of change events (each describing a state change, published release, updated company figures, or company news), a boolean has_more indicating if more pages exist, and a next_cursor string to use in the subsequent paginated request.","failureModes":["Invalid cursor format (must be 1-18 digits) returns a 400 error","More than 200 company addresses in ?companies= parameter returns an error","Invalid event type or news kind enum value causes a 400 bad request","Empty events array returned if no changes occurred since the given cursor","Payment not processed (402) if x402 micropayment header is missing or incorrect"],"whenToPreferThis":"Use this endpoint when you need to poll for incremental changes — new events since a known point in time — across briefing states, company releases, and financial figures. It is the right choice when you are building a monitoring loop or change-detection pipeline for a set of tracked companies, rather than fetching a full snapshot of current data. The cursor-based pagination makes it suitable for reliable, stateless polling at regular intervals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:40:51.661Z","isFirstParty":false,"canonicalSlug":"prereason-change-events-feed-d218827c"}