Stock News

Get Stock News

Request Class：NewsStockListRequest

Description

Retrieves the news list of a specified stock, corresponding to the news_stock_list method.

Only a single symbol is supported; batch queries are not supported. Query multiple stocks one at a time.
Paginated by pageCount / pageSize; the first page (pageCount=1) contains the latest articles.

Parameters

NewsStockListRequest.newRequest(String symbol, Language lang, Integer pageCount, Integer pageSize)

Parameter	Type	Required	Description
symbol	String	Yes	Stock symbol, e.g. `AAPL`. Single symbol only; batch queries are not supported
lang	Language	No	Language enum: `zh_CN` / `zh_TW` / `en_US`
pageCount	Integer	No	Page number, starting from 1, default 1, value >= 1
pageSize	Integer	No	Page size, default 20, range 1–50

Response

com.tigerbrokers.stock.openapi.client.https.response.news.NewsStockListResponse

The returned data can be accessed via NewsStockListResponse.getNewsPageItem(), which returns a NewsPageItem (com.tigerbrokers.stock.openapi.client.https.domain.news.item.NewsPageItem) object with the following fields:

Field	Type	Description
items	`List<NewsItem>`	News article list
pageCount	Integer	Current page number
pageSize	Integer	Page size
totalPage	Integer	Total number of pages
totalSize	Integer	Total number of articles

Each NewsItem (com.tigerbrokers.stock.openapi.client.https.domain.news.item.NewsItem) has the following fields:

Field	Type	Description
id	String	Article ID
title	String	Title
summary	String	Summary
pubTimestamp	Long	Publication timestamp (seconds)
url	String	Article URL

Example Request

TigerHttpClient client = TigerHttpClient.getInstance().clientConfig(
    ClientConfig.DEFAULT_CONFIG);

NewsStockListRequest request = NewsStockListRequest.newRequest("AAPL", Language.en_US, 1, 20);
NewsStockListResponse response = client.execute(request);
if (response.isSuccess()) {
  for (NewsItem item : response.getNewsPageItem().getItems()) {
    System.out.println(item.getTitle() + " — " + item.getUrl());
  }
} else {
  System.out.println("response error:" + response.getMessage());
}

Example Response

{
  "items": [
    {
      "id": "",
      "title": "",
      "summary": "",
      "pubTimestamp": 1793906282,
      "url": "https://xxxx"
    }
  ],
  "pageCount": 1,
  "pageSize": 20,
  "totalPage": 14,
  "totalSize": 265
}

Rate Limit

The base rate limit is 60 requests/min.