市场要闻

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

GetMarketNews

func (c *NewsClient) GetMarketNews(req model.NewsHighlightListRequest) (*model.NewsPage, error)

说明

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

参数

参数名	类型	是否必填	描述
`req.LastID`	`string`	No	上一页最后一条的 `ID`；空字符串从最新开始
`req.Lang`	`string`	No	`zh_CN` / `zh_TW` / `en_US`；空字符串不发送

*model.NewsPage，出错时返回 error。

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

新闻条目具有以下属性：

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

示例

package main

import (
    "fmt"
    "log"
    "github.com/tigerfintech/openapi-go-sdk/config"
    "github.com/tigerfintech/openapi-go-sdk/model"
    "github.com/tigerfintech/openapi-go-sdk/news"
)

func main() {
    cfg, err := config.NewClientConfig()
    if err != nil { log.Fatal(err) }
    newsClient := news.NewNewsClientFromConfig(cfg)
    page, err := newsClient.GetMarketNews(model.NewsHighlightListRequest{Lang: "zh_CN"})
    if err != nil { log.Fatal(err) }
    if len(page.Items) > 0 {
        cursor := page.Items[len(page.Items)-1].ID
        next, err := newsClient.GetMarketNews(model.NewsHighlightListRequest{Lang: "zh_CN", LastID: cursor})
        if err != nil { log.Fatal(err) }
        fmt.Println(next.Items)
    }
}

返回示例

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