Skip to main content

Launch of News API​

Effective April 17, 2026

Stay on top of market developments with the News API — a new endpoint that allows you to programmatically fetch market news articles for the instruments you trade.

What's New?​

News API (GET /v2/news)

Retrieve news articles in three ways by specifying the category parameter:

  1. By instrument keys — Set category=instrument_keys and provide up to 30 instrument keys to get news specific to those instruments.
  2. By positions — Set category=positions to automatically fetch news for all instruments in your current open positions. No instrument_keys parameter is required.
  3. By holdings — Set category=holdings to automatically fetch news for all instruments in your holdings portfolio. No instrument_keys parameter is required.

Key Details​

  • Each news item includes a headline, summary, thumbnail URL, article link, and published timestamp (Unix ms).
  • The response is structured as an array of objects keyed by instrument key, making it easy to map articles to specific instruments.
  • Pagination is supported via page_number (1–100) and page_size (1–100, default 100).
  • A maximum of 30 instrument keys can be requested per call when using category=instrument_keys.

How to Get Started​

Refer to the Get News API documentation for detailed request parameters, response structure, error codes, and code examples in Python, Node.js, Java, and PHP.