个股新闻

使用 TigerOpenAPI.News.NewsClient 查询个股新闻和市场要闻，配置方式与该 SDK 的快速入门相同。资讯客户端使用主网关配置，查询资讯不需要抢占实时行情设备访问权。

GetStockNewsAsync

Task<NewsStockListResponse> GetStockNewsAsync(string symbol, Language? lang = null, int? pageCount = null, int? pageSize = null)

说明

查询单只股票的新闻列表，对应 news_stock_list。仅支持单标的，使用页码和每页条数翻页，第一页从最新文章开始。

参数

参数名	类型	是否必填	描述
`symbol`	`string`	Yes	单只股票代码，如 `AAPL`
`lang`	`Language?`	No	`null` 使用配置语言；可用 `zh_CN` / `zh_TW` / `en_US`
`pageCount`	`int?`	No	`null` 不发送，服务端默认 1；显式值须大于等于 1
`pageSize`	`int?`	No	`null` 不发送，服务端默认 20；显式值须为 1–50

响应继承 TigerResponse；先检查 IsSuccess()，分页对象为 response.Data（NewsPageItem）。

属性名	类型	描述
`Items`	`List<NewsItem>`	当前页资讯
`PageCount`	`int`	当前页码；市场要闻恒为 1
`PageSize`	`int`	每页条数
`TotalPage`	`int`	总页数
`TotalSize`	`int`	总条数

新闻条目具有以下属性：

属性名	类型	描述
`Id`	`string`	文章 ID，可作市场要闻下一页游标
`Title`	`string`	标题
`Summary`	`string`	摘要
`PubTimestamp`	`long`	发布时间，秒级时间戳
`Url`	`string`	详情页 URL

示例

using System;
using TigerOpenAPI.Common.Enum;
using TigerOpenAPI.Config;
using TigerOpenAPI.News;

TigerConfig config = new() { ConfigFilePath = "your_config_directory_path", Language = Language.zh_CN };
NewsClient newsClient = new(config);
var response = await newsClient.GetStockNewsAsync("AAPL", Language.zh_CN, pageCount: 1, pageSize: 20);
if (response is null || !response.IsSuccess()) throw new InvalidOperationException(response?.Message ?? "empty response");
foreach (var item in response.Data.Items) Console.WriteLine($"{item.PubTimestamp} {item.Title} {item.Url}");

返回示例

以下 JSON 根据 SDK 固定测试数据构造，展示响应 data 的字段结构；实际调用返回上文列出的 SDK 对象。

{
  "items": [
    {
      "id": "123456",
      "title": "Apple Q2",
      "summary": "Earnings beat",
      "pubTimestamp": 1729413600,
      "url": "https://example.com/news/123456"
    }
  ],
  "pageCount": 1,
  "pageSize": 20,
  "totalPage": 1,
  "totalSize": 1
}

请求频率

基础限流为 60 次/分钟。

Updated about 17 hours ago

Did this page help you?