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

GoalEndpointResult
Read the latest news across the marketList newsArticles with a headline, a summary, a link, and the companies they name.
Read news about one companyCompany newsThe same articles, filtered to one company.
Stream market headlines in real timeReal-time newsOne 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.