Market news
The three news endpoints return articles about listed companies or stream short market headlines over a WebSocket. Articles come from external publishers and ROIC and include the companies they reference.
Choose an endpoint
| Goal | Endpoint | Result |
|---|---|---|
| Read the latest news across the market | List news | Articles with a headline, a summary, a link, and the companies they name. |
| Read news about one company | Company news | The same articles, filtered to one company. |
| Stream market headlines in real time | Real-time news | One or two sentences per headline, sent over a WebSocket. |
Both news lists sort newest first and accept the same published_at filters.
To keep a list current, set published_at.gt to your newest published_at.
To read news for a period, combine published_at.gte and published_at.lt.
For more results, follow next_page_url unchanged.
Common use cases
- Show the latest company news next to its financials, with links to the full articles.
- Poll Company news for each portfolio holding and forward new articles to a chat channel.
- Stream Real-time news into a scrolling ticker in a trading or research app.
Next steps
See pagination and API errors for shared response handling.