通用

获取市场状态

功能说明

获取市场状态。

方法签名

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"
  }
]

获取交易日历

功能说明

交易日历。

方法签名

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

([]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
  }
]

获取行情权限

功能说明

查询行情权限详情。

方法签名

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

参数

model.QuotePermissionRequest

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

([]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
  }
]

获取 K 线额度

功能说明

K 线配额查询。

方法签名

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

参数

model.KlineQuotaRequest

参数	类型	必填	默认值	说明
`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`

示例

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

返回示例

[
  {
    "method": "kline",
    "used": 120,
    "quota": 6000,
    "detail": []
  }
]

获取增值权益

功能说明

获取用户增值权益。

方法签名

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`

示例

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

返回示例

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