证券

获取股票代码列表

功能说明

查询全量合约代码。服务端返回字符串列表，不是对象列表。

方法签名

func (c *QuoteClient) GetSymbols(req model.SymbolsRequest) ([]string, error)

参数

model.SymbolsRequest

参数	类型	必填	默认值	说明
`Market`	`string`	否	空值省略	无；可选值：ALL, US, HK, CN, SG
`SecType`	`string`	否	空值省略	无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
`IncludeOtc`	`bool`	否	`false` 时省略	是否包含 OTC 标的
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US

([]string, error)

示例

result, err := qc.GetSymbols(model.SymbolsRequest{
	Market: "US",
	SecType: "STK",
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  "AAPL",
  "MSFT",
  "GOOGL",
  "AMZN",
  "TSLA"
]

调用频率

基础限流为 10 次/分钟。

获取股票代码和名称列表

功能说明

查询全量合约代码+名称。

方法签名

func (c *QuoteClient) GetSymbolNames(req model.SymbolsRequest) ([]model.SymbolName, error)

参数

model.SymbolsRequest

参数	类型	必填	默认值	说明
`Market`	`string`	否	空值省略	无；可选值：ALL, US, HK, CN, SG
`SecType`	`string`	否	空值省略	无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US
`IncludeOtc`	`bool`	否	false 时省略	IncludeOtc 字段值

([]model.SymbolName, error)。关键字段来自 model.SymbolName：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`Name`	`string`	`name`	标的名称
`Market`	`string`	`market`	市场代码

示例

result, err := qc.GetSymbolNames(model.SymbolsRequest{
	Market: "US",
	SecType: "STK",
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "symbol": "AAPL",
    "name": "Apple Inc",
    "market": "US"
  },
  {
    "symbol": "MSFT",
    "name": "Microsoft Corp",
    "market": "US"
  },
  {
    "symbol": "GOOGL",
    "name": "Alphabet Inc",
    "market": "US"
  }
]

调用频率

基础限流为 10 次/分钟。

获取交易元数据

功能说明

交易元数据。

方法签名

func (c *QuoteClient) GetTradeMetas(req model.TradeMetasRequest) ([]model.TradeMeta, error)

参数

model.TradeMetasRequest

参数	类型	必填	默认值	说明
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US
`Symbols`	`[]string`	否	空集合时省略	标的代码列表

([]model.TradeMeta, error)。关键字段来自 model.TradeMeta：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`LotSize`	`int`	`lotSize`	每手数量
`MinTick`	`float64`	`minTick`	最小报价单位
`SpreadScale`	`float64`	`spreadScale`	报价价差单位
`ShortableFlag`	`string`	`shortableFlag`	是否可卖空标识
`MarginableFlag`	`string`	`marginableFlag`	是否可融资标识

示例

result, err := qc.GetTradeMetas(model.TradeMetasRequest{
	Symbols: []string{"AAPL"},
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "symbol": "AAPL",
    "lotSize": 1,
    "minTick": 0.01,
    "spreadScale": 0.01,
    "shortableFlag": "Y",
    "marginableFlag": "Y"
  }
]

调用频率

基础限流为 60 次/分钟。

获取实时行情

功能说明

获取股票实时行情。

方法签名

func (c *QuoteClient) GetRealTimeQuote(req model.BriefRequest) ([]model.Brief, error)

参数

model.BriefRequest

参数	类型	必填	默认值	说明
`Symbols`	`[]string`	否	空值省略	标的代码列表
`IncludeHourTrading`	`*bool`	否	`nil` 时省略	是否包含盘前盘后行情；指针可区分显式 `false` 与省略
`SecType`	`string`	否	空值省略	无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US

([]model.Brief, error)。关键字段来自 model.Brief：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`Open`	`float64`	`open`	开盘价
`High`	`float64`	`high`	最高价
`Low`	`float64`	`low`	最低价
`Close`	`float64`	`close`	收盘价
`PreClose`	`float64`	`preClose`	昨收价
`LatestPrice`	`float64`	`latestPrice`	最新价
`LatestTime`	`int64`	`latestTime`	最新成交时间戳
`AskPrice`	`float64`	`askPrice`	卖一价
`AskSize`	`int64`	`askSize`	卖一数量
`BidPrice`	`float64`	`bidPrice`	买一价
`BidSize`	`int64`	`bidSize`	买一数量
`Volume`	`int64`	`volume`	成交量
`Amount`	`float64`	`amount`	成交额
`Status`	`string`	`status`	行情状态
`AdjPreClose`	`float64`	`adjPreClose`	复权昨收价
`Change`	`float64`	`change`	涨跌额
`ChangeRate`	`float64`	`changeRate`	涨跌幅
`Amplitude`	`float64`	`amplitude`	振幅
`Expiry`	`int64`	`expiry`	到期日时间戳
`Strike`	`string`	`strike`	行权价
`Right`	`string`	`right`	期权类型
`Multiplier`	`int`	`multiplier`	合约乘数
`OpenInterest`	`int64`	`openInterest`	未平仓量

示例

result, err := qc.GetRealTimeQuote(model.BriefRequest{
	Symbols: []string{"AAPL"},
	SecType: "STK",
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "symbol": "AAPL",
    "open": 304.81,
    "high": 310.69,
    "low": 300.0,
    "close": 308.91,
    "preClose": 333.43,
    "latestPrice": 308.91,
    "latestTime": 1785528000000,
    "askPrice": 310.97,
    "askSize": 400,
    "bidPrice": 310.89,
    "bidSize": 80,
    "volume": 176739024,
    "amount": 54581469120.0,
    "status": "NORMAL"
  }
]

调用频率

基础限流为 120 次/分钟。

获取延迟行情

功能说明

获取延迟行情.

方法签名

func (c *QuoteClient) GetDelayedQuote(req model.StockDelayBriefsRequest) ([]model.Brief, error)

查询延迟行情；参数

model.StockDelayBriefsRequest

参数	类型	必填	默认值	说明
`SecType`	`string`	否	空值省略	无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US
`Symbols`	`[]string`	否	空集合时省略	标的代码列表

([]model.Brief, error)。关键字段来自 model.Brief：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`Open`	`float64`	`open`	开盘价
`High`	`float64`	`high`	最高价
`Low`	`float64`	`low`	最低价
`Close`	`float64`	`close`	收盘价
`PreClose`	`float64`	`preClose`	昨收价
`LatestPrice`	`float64`	`latestPrice`	最新价
`LatestTime`	`int64`	`latestTime`	最新成交时间戳
`AskPrice`	`float64`	`askPrice`	卖一价
`AskSize`	`int64`	`askSize`	卖一数量
`BidPrice`	`float64`	`bidPrice`	买一价
`BidSize`	`int64`	`bidSize`	买一数量
`Volume`	`int64`	`volume`	成交量
`Status`	`string`	`status`	行情状态
`AdjPreClose`	`float64`	`adjPreClose`	复权昨收价
`Change`	`float64`	`change`	涨跌额
`ChangeRate`	`float64`	`changeRate`	涨跌幅
`Amplitude`	`float64`	`amplitude`	振幅
`Expiry`	`int64`	`expiry`	到期日时间戳
`Strike`	`string`	`strike`	行权价
`Right`	`string`	`right`	期权类型
`Multiplier`	`int`	`multiplier`	合约乘数
`OpenInterest`	`int64`	`openInterest`	未平仓量

示例

result, err := qc.GetDelayedQuote(model.StockDelayBriefsRequest{
	Symbols: []string{"AAPL"},
	SecType: "STK",
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "symbol": "AAPL",
    "open": 304.81,
    "high": 310.69,
    "low": 300.0,
    "close": 308.91,
    "preClose": 333.43,
    "latestPrice": 308.91,
    "latestTime": 1785528000000,
    "askPrice": 310.97,
    "askSize": 400,
    "bidPrice": 310.89,
    "bidSize": 80,
    "volume": 176739024,
    "status": "NORMAL"
  }
]

调用频率

基础限流为 10 次/分钟。

获取 K 线数据

功能说明

获取股票 K 线数据，支持按时间范围或索引分页。

方法签名

func (c *QuoteClient) GetKline(req model.KlineRequest) ([]model.Kline, error)

参数

model.KlineRequest

参数	类型	必填	默认值	说明
`Period`	`string`	否	空值省略	无；可选值：day, week, month, year, 1min, 5min, 15min, 30min, 60min
`Right`	`string`	否	空值省略	无；可选值：PUT, CALL (option side); br, nr when used as quote adjustment
`BeginTime`	`int64`	否	空值省略	无；与 BeginIndex/EndIndex 二选一；毫秒时间戳
`EndTime`	`int64`	否	空值省略	无；与 BeginIndex/EndIndex 二选一；毫秒时间戳
`Limit`	`int`	否	零值省略	返回数量
`BeginIndex`	`int`	否	零值省略	起始索引；与时间范围二选一
`EndIndex`	`int`	否	零值省略	结束索引；与时间范围二选一
`PageToken`	`string`	否	空值省略	分页游标
`TradeSession`	`string`	否	空值省略	交易时段：`PreMarket`、`Regular`、`AfterHours`、`OverNight`
`Date`	`string`	否	空值省略	查询日期
`WithFundamental`	`*bool`	否	`nil` 时省略	是否包含基本面数据；指针可区分显式 `false` 与省略
`SecType`	`string`	否	空值省略	证券类型；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US
`Symbols`	`[]string`	否	空集合时省略	标的代码列表

时间范围与索引范围不可同时使用。

([]model.Kline, error)。关键字段来自 model.Kline：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`Period`	`string`	`period`	数据周期
`NextPageToken`	`string`	`nextPageToken`	下一页令牌
`Items`	`[]KlineItem`	`items`	数据条目列表

KlineItem 字段

字段	类型	说明
`Time`	`int64`	时间戳
`Volume`	`int64`	成交量
`Open`	`float64`	开盘价
`Close`	`float64`	收盘价
`High`	`float64`	最高价
`Low`	`float64`	最低价
`Amount`	`float64`	金额

示例

result, err := qc.GetKline(model.KlineRequest{
	Symbols: []string{"AAPL"},
	Period: "day",
	Right: "CALL",
	BeginTime: 1735689600000,
	EndTime: 1738281600000,
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "symbol": "AAPL",
    "period": "day",
    "nextPageToken": null,
    "items": [
      {
        "time": 1785384000000,
        "volume": 74817792,
        "open": 333.10,
        "close": 333.43,
        "high": 334.75,
        "low": 329.59,
        "amount": 24701334239.0
      },
      {
        "time": 1785470400000,
        "volume": 132489137,
        "open": 304.81,
        "close": 308.91,
        "high": 310.69,
        "low": 300.0,
        "amount": 40348574927.0
      }
    ]
  }
]

调用频率

基础限流为 60 次/分钟。

分页获取 K 线数据

功能说明

分页获取股票 K 线，客户端循环直到收集足够数据后合并返回。

方法签名

func (c *QuoteClient) GetKlineByPage(req model.KlineByPageRequest) ([]model.KlineItem, error)

参数

model.KlineByPageRequest

参数	类型	必填	默认值	说明
`Symbol`	`string`	否	空值省略	标的代码
`SecType`	`string`	否	空值省略	证券类型；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
`Period`	`string`	否	空值省略	无；可选值：day, week, month, year, 1min, 5min, 15min, 30min, 60min
`BeginTime`	`int64`	否	零值省略	开始时间，毫秒时间戳
`EndTime`	`int64`	否	零值省略	结束时间，毫秒时间戳
`TotalSize`	`int`	否	`<= 0` 时为 1000	想获取的总条数
`PageSize`	`int`	否	`<= 0` 时为 200	每页条数
`Right`	`string`	否	空值省略	无；可选值：PUT, CALL (option side); br, nr when used as quote adjustment
`TradeSession`	`string`	否	空值省略	交易时段：`PreMarket`、`Regular`、`AfterHours`、`OverNight`
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US

分页结果按时间升序合并。

([]model.KlineItem, error)。关键字段来自 model.KlineItem：

字段	类型	JSON 字段	说明
`Time`	`int64`	`time`	时间戳
`Volume`	`int64`	`volume`	成交量
`Open`	`float64`	`open`	开盘价
`Close`	`float64`	`close`	收盘价
`High`	`float64`	`high`	最高价
`Low`	`float64`	`low`	最低价
`Amount`	`float64`	`amount`	成交额

示例

result, err := qc.GetKlineByPage(model.KlineByPageRequest{
	Symbol: "AAPL",
	Period: "day",
	BeginTime: 1735689600000,
	EndTime: 1738281600000,
	TotalSize: 100,
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "time": 1785384000000,
    "volume": 74817792,
    "open": 333.10,
    "close": 333.43,
    "high": 334.75,
    "low": 329.59,
    "amount": 24701334239.0
  },
  {
    "time": 1785470400000,
    "volume": 132489137,
    "open": 304.81,
    "close": 308.91,
    "high": 310.69,
    "low": 300.0,
    "amount": 40348574927.0
  }
]

获取分时数据

功能说明

获取股票当日分时数据。此方法没有 SecType 参数。

方法签名

func (c *QuoteClient) GetTimeline(symbols []string) ([]model.Timeline, error)

参数

参数	类型	必填	SDK 默认值	约束
`symbols`	`[]string`	是	无	标的代码列表；SDK 不设置批量上限

([]model.Timeline, error)。关键字段来自 model.Timeline：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`Period`	`string`	`period`	数据周期
`PreClose`	`float64`	`preClose`	昨收价
`Intraday`	`*TimelineBucket`	`intraday`	日间分时数据
`PreHours`	`*TimelineBucket`	`preHours`	盘前分时数据
`AfterHours`	`*TimelineBucket`	`afterHours`	盘后分时数据

TimelineBucket 字段

字段	类型	说明
`Items`	`[]TimelineItem`	结果条目

TimelineItem 字段

字段	类型	说明
`Time`	`int64`	时间戳
`Volume`	`int64`	成交量
`Price`	`float64`	价格
`AvgPrice`	`float64`	AvgPrice 字段值

示例

result, err := qc.GetTimeline([]string{"AAPL"})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "symbol": "AAPL",
    "period": "day",
    "preClose": 333.43,
    "intraday": {
      "items": [
        {"time": 1785504600000, "price": 304.05, "avgPrice": 304.77, "volume": 3808851},
        {"time": 1785504660000, "price": 301.93, "avgPrice": 304.60, "volume": 1704737},
        {"time": 1785504720000, "price": 302.03, "avgPrice": 304.24, "volume": 2029081}
      ]
    },
    "preHours": null,
    "afterHours": null
  }
]

调用频率

基础限流为 120 次/分钟。

获取股票当前分时数据

功能说明

通过请求对象获取股票当前分时数据。

方法签名

func (c *QuoteClient) GetTimelineByReq(req model.TimelineRequest) ([]model.Timeline, error)

参数

参数	类型	必填	默认值	说明
`Symbols`	`[]string`	否	空集合时省略	标的代码列表
`SecType`	`string`	否	空值省略	证券类型；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND

([]model.Timeline, error)。

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`Period`	`string`	`period`	数据周期
`PreClose`	`float64`	`preClose`	昨收价
`Intraday`	`*TimelineBucket`	`intraday`	日间分时数据
`PreHours`	`*TimelineBucket`	`preHours`	盘前分时数据
`AfterHours`	`*TimelineBucket`	`afterHours`	盘后分时数据

TimelineBucket 字段

字段	类型	说明
`Items`	`[]TimelineItem`	结果条目

TimelineItem 字段

字段	类型	说明
`Time`	`int64`	时间戳
`Volume`	`int64`	成交量
`Price`	`float64`	价格
`AvgPrice`	`float64`	均价

示例

result, err := qc.GetTimelineByReq(model.TimelineRequest{
	Symbols: []string{"AAPL"},
	SecType: "STK",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

调用频率

基础限流为 120 次/分钟。

获取历史分时数据

功能说明

获取股票历史分时。

方法签名

func (c *QuoteClient) GetTimelineHistory(req model.TimelineHistoryRequest) ([]model.Timeline, error)

参数

model.TimelineHistoryRequest

参数	类型	必填	默认值	说明
`Date`	`string`	否	空值省略	无；yyyy-MM-dd
`Right`	`string`	否	空值省略	无；可选值：PUT, CALL (option side); br, nr when used as quote adjustment
`TradeSession`	`string`	否	空值省略	交易时段：`PreMarket`、`Regular`、`AfterHours`、`OverNight`
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US
`Symbols`	`[]string`	否	空集合时省略	标的代码列表

([]model.Timeline, error)。关键字段来自 model.Timeline：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`Period`	`string`	`period`	数据周期
`PreClose`	`float64`	`preClose`	昨收价
`Intraday`	`*TimelineBucket`	`intraday`	日间分时数据
`PreHours`	`*TimelineBucket`	`preHours`	盘前分时数据
`AfterHours`	`*TimelineBucket`	`afterHours`	盘后分时数据

TimelineBucket 字段

字段	类型	说明
`Items`	`[]TimelineItem`	结果条目

TimelineItem 字段

字段	类型	说明
`Time`	`int64`	时间戳
`Volume`	`int64`	成交量
`Price`	`float64`	价格
`AvgPrice`	`float64`	AvgPrice 字段值

示例

result, err := qc.GetTimelineHistory(model.TimelineHistoryRequest{
	Symbols: []string{"AAPL"},
	Date: "2025-01-15",
	Right: "CALL",
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "symbol": "AAPL",
    "period": "day",
    "preClose": 333.43,
    "intraday": {
      "items": [
        {"time": 1785504600000, "price": 304.05, "avgPrice": 304.77, "volume": 3808851},
        {"time": 1785504660000, "price": 301.93, "avgPrice": 304.60, "volume": 1704737},
        {"time": 1785504720000, "price": 302.03, "avgPrice": 304.24, "volume": 2029081}
      ]
    },
    "preHours": null,
    "afterHours": null
  }
]

调用频率

基础限流为 60 次/分钟。

获取逐笔成交

功能说明

获取逐笔成交数据，支持分页。

方法签名

func (c *QuoteClient) GetTradeTick(req model.TradeTickRequest) ([]model.TradeTick, error)

参数

model.TradeTickRequest

参数	类型	必填	默认值	说明
`Limit`	`int`	否	零值省略	同时提供 `BeginIndex`、`EndIndex` 且跨度不超过 2,000 时，省略使用 2,000；其他情况使用 200；大于等于 2,000 时按 2,000 处理
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US
`Symbols`	`[]string`	否	空集合时省略	标的代码列表
`BeginIndex`	`int`	否	零值时省略	起始索引
`EndIndex`	`int`	否	零值时省略	结束索引

([]model.TradeTick, error)。关键字段来自 model.TradeTick：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`BeginIndex`	`int64`	`beginIndex`	起始索引
`EndIndex`	`int64`	`endIndex`	结束索引
`Items`	`[]TradeTickItem`	`items`	数据条目列表

TradeTickItem 字段

字段	类型	说明
`Time`	`int64`	时间戳
`Volume`	`int64`	成交量
`Price`	`float64`	价格
`Type`	`string`	业务或产品类型

示例

result, err := qc.GetTradeTick(model.TradeTickRequest{
	Symbols: []string{"AAPL"},
	Limit: 20,
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "symbol": "AAPL",
    "beginIndex": 2062878,
    "endIndex": 2062880,
    "items": [
      {"time": 1785528000829, "volume": 36, "price": 308.91, "type": "-"},
      {"time": 1785528000899, "volume": 1, "price": 309.0, "type": "*"}
    ]
  }
]

调用频率

基础限流为 120 次/分钟。

获取深度行情

功能说明

获取订单簿。

方法签名

func (c *QuoteClient) GetQuoteDepth(req model.DepthQuoteRequest) ([]model.Depth, error)

参数

model.DepthQuoteRequest

参数	类型	必填	默认值	说明
`Market`	`string`	否	空值省略	无；可选值：ALL, US, HK, CN, SG
`TradeSession`	`string`	否	空值省略	交易时段：`PreMarket`、`Regular`、`AfterHours`、`OverNight`
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US
`Symbols`	`[]string`	否	空集合时省略	标的代码列表

([]model.Depth, error)。关键字段来自 model.Depth：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`Asks`	`[]DepthLevel`	`asks`	卖盘档位
`Bids`	`[]DepthLevel`	`bids`	买盘档位

`DepthLevel` 字段	类型	JSON 字段	说明
`Price`	`float64`	`price`	价格
`Count`	`int`	`count`	委托笔数
`Volume`	`int64`	`volume`	成交量

示例

result, err := qc.GetQuoteDepth(model.DepthQuoteRequest{
	Symbols: []string{"AAPL"},
	Market: "US",
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "symbol": "AAPL",
    "asks": [
      {"price": 310.97, "volume": 400, "count": 0},
      {"price": 310.98, "volume": 200, "count": 0},
      {"price": 311.00, "volume": 1500, "count": 0}
    ],
    "bids": [
      {"price": 310.89, "volume": 80, "count": 0},
      {"price": 310.88, "volume": 300, "count": 0},
      {"price": 310.85, "volume": 600, "count": 0}
    ]
  }
]

调用频率

基础限流为 60 次/分钟。

获取资金流向

功能说明

获取资金流向数据。period 可选值：day/intraday/week/month。

方法签名

func (c *QuoteClient) GetCapitalFlow(symbol, market, period string) (*model.CapitalFlow, error)

参数

参数	类型	必填	SDK 默认值	约束
`symbol`	`string`	是	无	标的代码
`market`	`string`	是	无	市场代码；SDK 枚举值为 `ALL/US/HK/CN/SG`
`period`	`string`	是	无	K 线周期；见 `BarPeriod` 枚举

(*model.CapitalFlow, error)。关键字段来自 model.CapitalFlow：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`Period`	`string`	`period`	数据周期
`Items`	`[]CapitalFlowItem`	`items`	数据条目列表

CapitalFlowItem 字段

字段	类型	说明
`Time`	`string`	时间戳
`Timestamp`	`int64`	Timestamp 字段值
`NetInflow`	`float64`	NetInflow 字段值

示例

result, err := qc.GetCapitalFlow("AAPL", "US", "day")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

{
  "symbol": "AAPL",
  "period": "day",
  "items": [
    {"time": 1785470400000, "netInflow": -52341890.50, "inBig": 182345000.0, "inMid": 95432100.0, "inSmall": 23456000.0, "outBig": 195678900.0, "outMid": 98765400.0, "outSmall": 59131690.5}
  ]
}

调用频率

基础限流为 60 次/分钟。

获取资金分布

功能说明

获取资金分布数据。

方法签名

func (c *QuoteClient) GetCapitalDistribution(symbol, market string) (*model.CapitalDistribution, error)

参数

参数	类型	必填	SDK 默认值	约束
`symbol`	`string`	是	无	标的代码
`market`	`string`	是	无	市场代码；SDK 枚举值为 `ALL/US/HK/CN/SG`

(*model.CapitalDistribution, error)。关键字段来自 model.CapitalDistribution：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`NetInflow`	`float64`	`netInflow`	净流入金额
`InAll`	`float64`	`inAll`	总流入金额
`InBig`	`float64`	`inBig`	大单流入金额
`InMid`	`float64`	`inMid`	中单流入金额
`InSmall`	`float64`	`inSmall`	小单流入金额
`OutAll`	`float64`	`outAll`	总流出金额
`OutBig`	`float64`	`outBig`	大单流出金额
`OutMid`	`float64`	`outMid`	中单流出金额
`OutSmall`	`float64`	`outSmall`	小单流出金额

示例

result, err := qc.GetCapitalDistribution("AAPL", "US")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

{
  "symbol": "AAPL",
  "netInflow": -52341890.50,
  "inAll": 301233100.0,
  "inBig": 182345000.0,
  "inMid": 95432100.0,
  "inSmall": 23456000.0,
  "outAll": 353574990.50,
  "outBig": 195678900.0,
  "outMid": 98765400.0,
  "outSmall": 59130690.50
}

调用频率

基础限流为 60 次/分钟。

获取交易榜单

功能说明

成交榜单（涨跌幅榜）。

方法签名

func (c *QuoteClient) GetTradeRank(req model.TradeRankRequest) ([]model.TradeRankItem, error)

参数

model.TradeRankRequest

参数	类型	必填	默认值	说明
`Market`	`string`	否	空值省略	无；可选值：ALL, US, HK, CN, SG
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US

([]model.TradeRankItem, error)。关键字段来自 model.TradeRankItem：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`Name`	`string`	`name`	名称
`LatestPr`	`float64`	`latestPrice`	最新价
`Change`	`float64`	`change`	涨跌额
`ChangeRate`	`float64`	`changeRate`	涨跌幅
`Volume`	`int64`	`volume`	成交量
`Amount`	`float64`	`amount`	成交额

示例

result, err := qc.GetTradeRank(model.TradeRankRequest{
	Market: "US",
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "symbol": "NVDA",
    "name": "NVIDIA Corp",
    "latestPrice": 132.15,
    "change": 8.42,
    "changeRate": 0.068,
    "volume": 385241000,
    "amount": 50871234567.0
  },
  {
    "symbol": "TSLA",
    "name": "Tesla Inc",
    "latestPrice": 285.50,
    "change": 12.30,
    "changeRate": 0.045,
    "volume": 112456000,
    "amount": 32089765432.0
  }
]

调用频率

基础限流为 10 次/分钟。

获取卖空数据

功能说明

做空数据。

方法签名

func (c *QuoteClient) GetShortInterest(req model.ShortInterestRequest) ([]model.ShortInterest, error)

参数

model.ShortInterestRequest

参数	类型	必填	默认值	说明
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US
`Symbols`	`[]string`	否	空集合时省略	标的代码列表

([]model.ShortInterest, error)。关键字段来自 model.ShortInterest：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`SettlementDate`	`string`	`settlementDate`	结算日期
`ShortInterest`	`float64`	`shortInterest`	卖空股数
`AvgDailyVolume`	`float64`	`avgDailyVolume`	日均成交量
`DaysToCover`	`float64`	`daysToCover`	回补天数
`PercentOfFloat`	`float64`	`percentOfFloat`	占流通股比例
`ShortInterestPrevious`	`float64`	`shortInterestPrevious`	上期卖空股数
`PercentChange`	`float64`	`percentChange`	变动百分比

示例

result, err := qc.GetShortInterest(model.ShortInterestRequest{
	Symbols: []string{"AAPL"},
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "symbol": "AAPL",
    "settlementDate": "2025-07-15",
    "shortInterest": 98234567.0,
    "avgDailyVolume": 65432100.0,
    "daysToCover": 1.5,
    "percentOfFloat": 0.65,
    "shortInterestPrevious": 96543210.0,
    "percentChange": 1.75
  }
]

调用频率

基础限流为 60 次/分钟。

获取经纪商席位

功能说明

经纪商持仓。

方法签名

func (c *QuoteClient) GetStockBroker(req model.StockBrokerRequest) (*model.StockBroker, error)

参数

model.StockBrokerRequest

参数	类型	必填	默认值	说明
`Limit`	`int`	否	零值省略	返回数量
`SecType`	`string`	否	空值省略	无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US
`Symbol`	`string`	否	空值时省略	标的代码

(*model.StockBroker, error)。关键字段来自 model.StockBroker：

字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`LevelAskList`	`[]StockBrokerItem`	`levelAskList`	卖方经纪商档位
`LevelBidList`	`[]StockBrokerItem`	`levelBidList`	买方经纪商档位

`StockBrokerItem` 字段	类型	JSON 字段	说明
`Level`	`int`	`level`	档位
`Price`	`float64`	`price`	价格
`Brokers`	`[]BrokerDetail`	`brokers`	经纪商列表

`BrokerDetail` 字段	类型	JSON 字段	说明
`ID`	`string`	`id`	经纪商标识
`Name`	`string`	`name`	名称

示例

result, err := qc.GetStockBroker(model.StockBrokerRequest{
	Symbol: "AAPL",
	Limit: 20,
	SecType: "STK",
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

{
  "symbol": "00700",
  "levelAskList": [
    {
      "level": 1,
      "price": 420.80,
      "brokers": [
        {"id": "8461", "name": "FUTU Securities"},
        {"id": "8577", "name": "HSBC"}
      ]
    }
  ],
  "levelBidList": [
    {
      "level": 1,
      "price": 420.60,
      "brokers": [
        {"id": "6997", "name": "China Investment"},
        {"id": "8134", "name": "BOC"},
        {"id": "5342", "name": "J.P. Morgan"}
      ]
    }
  ]
}

调用频率

基础限流为 60 次/分钟。