个股新闻

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

get_stock_news

pub async fn get_stock_news(&self, req: NewsStockListRequest) -> Result<NewsPage, TigerError>

说明

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

参数

参数名	类型	是否必填	描述
`req.symbol`	`String`	Yes	单只股票代码，如 `AAPL`
`req.lang`	`Option<Language>`	No	`None` 不发送；枚举为 `ZhCn` / `ZhTw` / `EnUs`
`req.page_count`	`Option<i32>`	No	`None` 不发送，服务端默认 1；显式值须大于等于 1
`req.page_size`	`Option<i32>`	No	`None` 不发送，服务端默认 20；显式值须为 1–50

Result<NewsPage, TigerError>。

属性名	类型	描述
`items`	`Vec<NewsItem>`	当前页资讯
`page_count`	`i32`	当前页码；市场要闻恒为 1
`page_size`	`i32`	每页条数
`total_page`	`i32`	总页数
`total_size`	`i32`	总条数

新闻条目具有以下属性：

属性名	类型	描述
`id`	`String`	文章 ID，可作市场要闻下一页游标
`title`	`String`	标题
`summary`	`String`	摘要
`pub_timestamp`	`i64`	发布时间，秒级时间戳
`url`	`String`	详情页 URL

示例

use tigeropen::config::ClientConfig;
use tigeropen::model::enums::Language;
use tigeropen::model::news_requests::NewsStockListRequest;
use tigeropen::news::NewsClient;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = ClientConfig::builder().build()?;
    let news_client = NewsClient::from_config(config);
    let page = news_client.get_stock_news(NewsStockListRequest {
        symbol: "AAPL".into(), lang: Some(Language::ZhCn),
        page_count: Some(1), page_size: Some(20),
    }).await?;
    for item in &page.items { println!("{} {} {}", item.pub_timestamp, item.title, item.url); }
    news_client.close();
    Ok(())
}

返回示例

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