What changed since your last read, paid per call or read with a key
Changed onOne page of PreReason's change events after a cursor: a live briefing's state label changing, a tracked release becoming known (the Fed's weekly balance sheet, the FOMC statement and target range, Treasury auction results, the EIA's weekly crude oil and natural gas stocks, ECB and Bank of Japan policy rates), and, for the companies a read names, figures stored for a newer period, an event driven situation the company briefing reports turning on, and filed news (for the USA: an 8-K's material events, leadership changes and results). Each event says what changed, when it happened, when PreReason knew it, the rule and where to fetch the briefing or metric it concerns; it carries no value.
With no cursor the read starts 24 hours back; each answer's next_cursor is where the next read starts. Events are kept 30 days. A company's events reach only a read that names the company in companies. kinds narrows company news; ownership reports come only to a read that names them.
A key on the Basic or Pro plan reads its plan's events and is never charged here. A caller with no key pays per read. A malformed cursor, an unknown event type, a malformed company, more than 200 companies or an unknown news kind answers 400, and nothing is charged.
Request
- Base URLhttps://api.prereason.com
- AuthHTTP bearer
Query parameters
The next_cursor of your previous read. Left out, the read starts 24 hours back.
Event types, comma separated, from state.changed, release.published, company.figures_updated, company.situation_changed and company.news. Every type when left out.
Company addresses, comma separated, at most 200. A company's events reach only a read that names it.
Company news kinds, comma separated, from earnings-release, material-event, leadership-change and ownership-report. Left out, every kind but ownership-report, which comes only when named.
Events a page holds, 1 to 100. Default 50.
Response
A page of events, its next_cursor and whether more follow
Changes
- info
added the media type
application/jsonfor the response with the status
- info
- info
added the new optional
queryrequest parameterkinds
- info