Improved
Rust SDK 版本更新
July 2nd, 2026 by ReadMe API
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 重命名:
StockDelayBriefsRequest→DelayedQuoteRequest,DepthQuoteRequest→QuoteDepthRequest,FutureBriefRequest→FutureRealTimeQuoteRequest,WarrantBriefsRequest→WarrantQuoteRequest。
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=0、get_option_kline返回空数据。现在strike正确序列化为 JSON number(310.0)。Brief.expiry反序列化:服务器对部分期权接口返回i64时间戳而非字符串,现在两种格式均可解析。- OCC 双空格解析:
"AAPL 260918C00275000"等包含填充空格的 OCC identifier 不再 panic。
0.5.1 (2026-07-07)
Deprecated
get_brief→get_real_time_quoteget_option_brief→get_option_quoteget_stock_delay_briefs→get_delayed_quoteget_warrant_briefs→get_warrant_quote
0.5.0 (2026-07-07)
Breaking
QuoteClient/TradeClient构造方式变更:新增from_config(config)构造器,不再需要手动创建HttpClient。- 行情接口多 symbol 支持:
get_kline、get_option_expiration、get_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。
