市场要闻
使用 TigerOpenAPI.News.NewsClient 查询个股新闻和市场要闻,配置方式与该 SDK 的快速入门相同。资讯客户端使用主网关配置,查询资讯不需要抢占实时行情设备访问权。
GetMarketNewsAsync
Task<NewsHighlightListResponse> GetMarketNewsAsync(Language? lang = null, string lastId = null)
说明
查询市场要闻列表,对应 news_highlight_list。不传游标从最新文章开始;下一页使用上一页最后一条新闻的 ID。请求不含页码或每页条数,响应页码恒为 1。空 items 是正常成功结果。
参数
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
lastId | string | No | 上一页最后一条的 Id;null 从最新开始 |
lang | Language? | No | null 使用配置语言;可用 zh_CN / zh_TW / en_US |
返回
响应继承 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.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 次/分钟。
Updated about 17 hours ago
Did this page help you?
