市场要闻

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

GetMarketNewsAsync

Task<NewsHighlightListResponse> GetMarketNewsAsync(Language? lang = null, string lastId = null)

说明

查询市场要闻列表,对应 news_highlight_list。不传游标从最新文章开始;下一页使用上一页最后一条新闻的 ID。请求不含页码或每页条数,响应页码恒为 1。空 items 是正常成功结果。

参数

参数名类型是否必填描述
lastIdstringNo上一页最后一条的 Id;null 从最新开始
langLanguage?Nonull 使用配置语言;可用 zh_CN / zh_TW / en_US

返回

响应继承 TigerResponse;先检查 IsSuccess(),分页对象为 response.Data(NewsPageItem)。

属性名类型描述
ItemsList<NewsItem>当前页资讯
PageCountint当前页码;市场要闻恒为 1
PageSizeint每页条数
TotalPageint总页数
TotalSizeint总条数

新闻条目具有以下属性:

属性名类型描述
Idstring文章 ID,可作市场要闻下一页游标
Titlestring标题
Summarystring摘要
PubTimestamplong发布时间,秒级时间戳
Urlstring详情页 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.GetMarketNewsAsync(Language.zh_CN);
if (response is null || !response.IsSuccess()) throw new InvalidOperationException(response?.Message ?? "empty response");
var items = response.Data.Items;
if (items.Count > 0) {
    var next = await newsClient.GetMarketNewsAsync(Language.zh_CN, lastId: items[items.Count - 1].Id);
    if (next is null || !next.IsSuccess()) throw new InvalidOperationException(next?.Message ?? "empty response");
    Console.WriteLine(next.Data.Items.Count);
}

返回示例

以下 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 次/分钟。


Did this page help you?