附录

客户端构造

pub fn QuoteClient::new(http_client: HttpClient) -> QuoteClient
pub fn TradeClient::new(http_client: HttpClient, account: impl Into<String>) -> TradeClient
pub fn TradeClient::with_secret_key(http_client: HttpClient, account: impl Into<String>, secret_key: impl Into<String>) -> TradeClient

行情的 HttpClient 应由 HttpClient::with_quote_server(config) 构造;交易用 HttpClient::new(config)。所有构造函数取得 HttpClient 所有权。

类型与默认值约定

  • 请求字段使用 snake_case;多数 Option<T> 的 Rust 默认值为 None 并不发送。
  • 响应多数使用 camelCase 反序列化。PlaceOrderResult.order_id 的 wire 字段例外为 snake_case。
  • 时间通常是 i64 Unix 毫秒;明确标为日期的字段使用 String YYYY-MM-DD
  • 金额和价格主要为 f64;数量按模型为 i64f64,不得互换。
  • 空响应由方法类型决定:Vec 方法为空 Vec,optional 方法为 None,直接 T 方法为 T::default()
  • OptionChainItem::from_date 和 OCC 辅助函数按标的推断时区;可用 _tz 变体显式指定。
  • 当前 SDK 模型字段为 OptionAnalysis.implied_vol30_days,不是 implied_vol_30_days

错误、权限与限流

TigerError 覆盖配置、序列化、HTTP、签名和服务端业务错误。不要在可变更操作上盲目重试。行情 license、账户类型、交易权限、市场状态和购买力均可导致拒绝。SDK 只声明少量客户端默认值,不声明全局服务端批量/时间/频率限制;以具体 API 和账户返回为准。

链接

本节页面


Did this page help you?