Improved

Rust SDK 版本更新

0.5.9 (2026-08-04)

New

  • 行情、交易和订单响应模型支持直接序列化为 JSON。

0.5.2 (2026-07-08)

Breaking

  • get_option_chain / get_option_quote / get_option_kline 签名变更:参数改为结构体(OptionChainRequest / OptionQuoteRequest / OptionKlineRequest),旧的 &[(&str, &str)] / &[&str] 签名不再支持。
  • get_option_expiration 新增 market 参数:查询港股期权到期日需传 Some("HK")
  • Request struct 重命名StockDelayBriefsRequestDelayedQuoteRequestDepthQuoteRequestQuoteDepthRequestFutureBriefRequestFutureRealTimeQuoteRequestWarrantBriefsRequestWarrantQuoteRequest

Added

  • OptionChainItem / OptionContractItem / OptionKlineItem:三种构造方式——::new()(直接传毫秒时间戳)、::from_date()(日期字符串,按 symbol 自动推断交易所时区)、::from_date_tz()(指定时区)。
  • 港股期权 identifier 格式支持parse_occ_identifier 同时支持空格分隔的 OCC 格式("AAPL 260918C00275000")和 HK 紧凑格式("TCH.HK260710C00295000")。

Fixed

  • strike 序列化:旧版本 strike 被序列化为字符串("310.000"),导致服务端无法匹配合约,get_option_quote 返回 latestPrice=0get_option_kline 返回空数据。现在 strike 正确序列化为 JSON number(310.0)。
  • Brief.expiry 反序列化:服务器对部分期权接口返回 i64 时间戳而非字符串,现在两种格式均可解析。
  • OCC 双空格解析"AAPL 260918C00275000" 等包含填充空格的 OCC identifier 不再 panic。

0.5.1 (2026-07-07)

Deprecated

  • get_briefget_real_time_quote
  • get_option_briefget_option_quote
  • get_stock_delay_briefsget_delayed_quote
  • get_warrant_briefsget_warrant_quote

0.5.0 (2026-07-07)

Breaking

  • QuoteClient / TradeClient 构造方式变更:新增 from_config(config) 构造器,不再需要手动创建 HttpClient
  • 行情接口多 symbol 支持:get_klineget_option_expirationget_option_kline 参数由单个 &str 改为 &[&str]get_option_chain 改为 &[(&str, &str)]
  • BarsByPageRequest.symbol 改为 symbols: Option<Vec<String>>

New

  • call_* 系列方法改为 pub,可直接用于自定义请求。

0.4.4 (2026-07-03)

Fixed

  • 修复机构账号在 trade_example 中未使用 secret_key 导致交易接口报 403 的问题。

0.4.3 (2026-06-24)

New

  • 新增冰山单支持,提供基础参数和完整参数两种订单构造方式。
  • 新增下单预览接口 TradeClient::preview_order()

0.4.2 (2026-06-09)

New

  • 新增期权提前行权接口,支持行权检查、提交/取消行权、查询行权记录和可行权持仓。
  • 支持机构账户 secret_key 配置,并在期权行权接口中自动注入。

Fixed

  • 修复解码错误信息丢失问题。

0.4.1 (2026-05-25)

New

  • 新增 token 自动刷新能力,支持自定义 token 读取/写入和手动刷新控制。

Fixed

  • 修复 push 回调死锁、若干响应模型字段解析、期货逐笔和资金历史解包等问题。

0.4.0 (2026-05-09)

New

  • 补齐交易、行情、基金、期货、期权、财经、推送等主要 OpenAPI 能力,达到与主流 SDK 的功能覆盖对齐。

Breaking

  • 多个交易和行情方法改为 request struct 参数,OrderStatus 枚举对齐 Java SDK。