通用

获取市场状态

功能说明

获取市场状态。

方法签名

func (c *QuoteClient) GetMarketState(market string) ([]model.MarketState, error)

参数

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

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

字段	类型	JSON 字段	说明
`Market`	`string`	`market`	市场代码
`MarketStatus`	`string`	`marketStatus`	市场状态名称
`Status`	`string`	`status`	市场状态代码
`OpenTime`	`string`	`openTime`	下次开市时间

示例

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

返回示例

[
  {
    "market": "US",
    "marketStatus": "Pre-Mkt",
    "status": "PRE_HOUR_TRADING",
    "openTime": "08-03 09:30:00 EDT"
  }
]

调用频率

基础限流为 10 次/分钟。

获取交易日历

功能说明

交易日历。

方法签名

func (c *QuoteClient) GetTradingCalendar(req model.TradingCalendarRequest) ([]model.TradingCalendarItem, error)

参数

model.TradingCalendarRequest

参数	类型	必填	默认值	说明
`Market`	`string`	否	空值省略	无；可选值：ALL, US, HK, CN, SG
`BeginDate`	`string`	否	空值省略	无；yyyy-MM-dd
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US
`EndDate`	`string`	否	空值时省略	结束日期

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

字段	类型	JSON 字段	说明
`Market`	`string`	`market`	市场代码
`Date`	`string`	`date`	日期
`IsTrading`	`bool`	`isTrading`	是否为交易日
`SessionType`	`string`	`sessionType`	交易时段类型

示例

result, err := qc.GetTradingCalendar(model.TradingCalendarRequest{
	Market: "US",
	BeginDate: "2025-01-01",
	EndDate: "2025-01-31",
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "market": "US",
    "date": "2025-07-28",
    "isTrading": true,
    "sessionType": "TRADING"
  },
  {
    "market": "US",
    "date": "2025-07-29",
    "isTrading": true,
    "sessionType": "TRADING"
  }
]

抢占行情设备访问权

功能说明

抢占行情设备访问权，将当前设备设为可访问行情的设备。此操作不会购买或授予新的行情权限。

方法签名

func (c *QuoteClient) GrabQuotePermission() ([]model.QuotePermission, error)

参数

无参数。

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

字段	类型	JSON 字段	说明
`Name`	`string`	`name`	行情权限名称
`ExpireAt`	`int64`	`expireAt`	权限到期时间戳

示例

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

返回示例

[
  {
    "name": "usStockQuote",
    "expireAt": 1824291899000
  },
  {
    "name": "hkStockQuoteLv2",
    "expireAt": -1
  },
  {
    "name": "usOptionQuoteLv2",
    "expireAt": 1794121342000
  }
]

调用频率

基础限流为 10 次/分钟。

获取行情权限

功能说明

查询行情权限详情。

方法签名

func (c *QuoteClient) GetQuotePermission(req model.QuotePermissionRequest) ([]model.QuotePermission, error)

参数

model.QuotePermissionRequest

参数	类型	必填	默认值	说明
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US
`BeginDate`	`string`	否	空值时省略	开始日期
`EndDate`	`string`	否	空值时省略	结束日期

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

字段	类型	JSON 字段	说明
`Name`	`string`	`name`	行情权限名称
`ExpireAt`	`int64`	`expireAt`	权限到期时间戳

示例

result, err := qc.GetQuotePermission(model.QuotePermissionRequest{
	BeginDate: "2025-01-01",
	EndDate: "2025-01-31",
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "name": "usStockQuote",
    "expireAt": 1824291899000
  },
  {
    "name": "hkStockQuoteLv2",
    "expireAt": -1
  },
  {
    "name": "usOptionQuoteLv2",
    "expireAt": 1794121342000
  }
]

调用频率

基础限流为 10 次/分钟。

获取 K 线额度

功能说明

K 线配额查询。

方法签名

func (c *QuoteClient) GetKlineQuota(req model.KlineQuotaRequest) ([]model.KlineQuota, error)

参数

model.KlineQuotaRequest

参数	类型	必填	默认值	说明
`WithDetails`	`bool`	否	`false` 时省略	是否请求每个标的的额度明细
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US

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

字段	类型	JSON 字段	说明
`Method`	`string`	`method`	配额所属方法
`Used`	`int`	`used`	已使用额度
`Quota`	`int`	`quota`	总额度
`Detail`	`[]KlineQuotaDetail`	`detail`	按标的划分的额度明细

`KlineQuotaDetail` 字段	类型	JSON 字段	说明
`Symbol`	`string`	`symbol`	标的代码
`Market`	`string`	`market`	市场代码
`UsedBars`	`int`	`usedBars`	已使用 K 线数量
`QuotaBars`	`int`	`quotaBars`	K 线数量额度
`LastAccess`	`int64`	`lastAccess`	最近访问时间戳

示例

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

返回示例

[
  {
    "method": "kline",
    "used": 120
  }
]

调用频率

基础限流为 10 次/分钟。

获取增值权益

功能说明

获取用户增值权益。

方法签名

func (c *QuoteClient) GetAddonEntitlement() (*model.AddonEntitlement, error)

参数

无参数。

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

字段	类型	JSON 字段	说明
`UserLevel`	`FlexString`	`userLevel`	用户套餐等级
`ActivePlan`	`*AddonActivePlan`	`activePlan`	当前生效套餐
`Addons`	`[]AddonInfo`	`addons`	附加套餐列表
`EffectiveEntitlement`	`*AddonEntitlementDetail`	`effectiveEntitlement`	生效后的权益额度明细

`AddonActivePlan` 字段	类型	JSON 字段	说明
`PlanType`	`string`	`planType`	套餐类型
`ExpireTime`	`int64`	`expireTime`	套餐到期时间戳

`AddonInfo` 字段	类型	JSON 字段	说明
`PlanType`	`string`	`planType`	附加套餐类型
`Active`	`bool`	`active`	是否生效
`StartTime`	`int64`	`startTime`	生效开始时间戳
`ExpireTime`	`int64`	`expireTime`	到期时间戳

`AddonEntitlementDetail` 字段	类型	JSON 字段	说明
`HistoryStockLimit`	`int`	`historyStockLimit`	股票历史行情额度
`HistoryStockRemaining`	`int`	`historyStockRemaining`	剩余股票历史行情额度
`HistoryFutureLimit`	`int`	`historyFutureLimit`	期货历史行情额度
`HistoryFutureRemaining`	`int`	`historyFutureRemaining`	剩余期货历史行情额度
`HistoryOptionLimit`	`int`	`historyOptionLimit`	期权历史行情额度
`HistoryOptionRemaining`	`int`	`historyOptionRemaining`	剩余期权历史行情额度
`SubscribeLimit`	`int`	`subscribeLimit`	行情订阅额度
`SubscribeRemaining`	`int`	`subscribeRemaining`	剩余行情订阅额度
`SubscribeDepthLimit`	`int`	`subscribeDepthLimit`	深度行情订阅额度
`SubscribeDepthRemaining`	`int`	`subscribeDepthRemaining`	剩余深度行情订阅额度
`HighFreqLimit`	`int`	`highFreqLimit`	高频行情频率上限
`MidFreqLimit`	`int`	`midFreqLimit`	中频行情频率上限
`LowFreqLimit`	`int`	`lowFreqLimit`	低频行情频率上限
`RateMultiple`	`int`	`rateMultiple`	频率倍率

示例

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

返回示例

{
  "userLevel": "1",
  "activePlan": null,
  "addons": [],
  "effectiveEntitlement": null
}