Docs
English

行情订阅

订阅股票行情

功能说明

订阅行情。

方法签名

func (c *PushClient) SubscribeQuote(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.SubscribeQuote([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

回调数据示例

基本行情（BASIC）：

{
    "symbol": "AAPL",
    "type": "BASIC",
    "timestamp": "1684766012120",
    "serverTimestamp": "1684766012129",
    "avgPrice": 174.1721,
    "latestPrice": 174.175,
    "latestPriceTimestamp": "1684766011918",
    "latestTime": "05-22 10:33:31 EDT",
    "preClose": 175.16,
    "volume": "12314802",
    "amount": 2144365591.41,
    "open": 173.98,
    "high": 174.71,
    "low": 173.45,
    "marketStatus": "Trading",
    "mi": {
        "p": 174.175,
        "a": 174.1721,
        "t": "1684765980000",
        "v": "57641",
        "o": 174.21,
        "h": 174.22,
        "l": 174.14
    }
}

最优报价（BBO）：

{
    "symbol": "AAPL",
    "type": "BBO",
    "timestamp": "1676992715509",
    "askPrice": 149.96,
    "askSize": "200",
    "askTimestamp": "1676992715367",
    "bidPrice": 149.94,
    "bidSize": "700",
    "bidTimestamp": "1676992715367"
}

取消订阅股票行情

功能说明

退订行情。

方法签名

func (c *PushClient) UnsubscribeQuote(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.UnsubscribeQuote([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

订阅逐笔成交

功能说明

订阅逐笔成交。

方法签名

func (c *PushClient) SubscribeTick(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.SubscribeTick([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

回调数据示例

{
    "symbol": "AAPL",
    "secType": "STK",
    "quoteLevel": "usQuoteBasic",
    "timestamp": 1676993925700,
    "ticks": [
        {
            "sn": 116202,
            "volume": 50,
            "tickType": "*",
            "price": 149.665,
            "time": 1676993924289,
            "cond": "US_REGULAR_SALE"
        }
    ]
}

取消订阅逐笔成交

功能说明

退订逐笔成交。

方法签名

func (c *PushClient) UnsubscribeTick(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.UnsubscribeTick([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

订阅深度行情

功能说明

订阅深度行情。

方法签名

func (c *PushClient) SubscribeDepth(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.SubscribeDepth([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

回调数据示例

{
    "symbol": "AAPL",
    "timestamp": "1676993368405",
    "ask": {
        "price": [149.69, 149.70, 149.71],
        "volume": ["100", "200", "185"]
    },
    "bid": {
        "price": [149.68, 149.67, 149.66],
        "volume": ["84", "100", "100"]
    }
}

取消订阅深度行情

功能说明

退订深度行情。

方法签名

func (c *PushClient) UnsubscribeDepth(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.UnsubscribeDepth([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

订阅期权行情

功能说明

订阅期权行情。

方法签名

func (c *PushClient) SubscribeOption(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.SubscribeOption([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

回调数据示例

{
    "symbol": "AAPL 20230317 150.0 CALL",
    "type": "BASIC",
    "timestamp": "1676994444927",
    "latestPrice": 4.83,
    "preClose": 6.21,
    "volume": "3181",
    "amount": 939117.01,
    "open": 4.85,
    "high": 5.6,
    "low": 4.64,
    "identifier": "AAPL  230317C00150000",
    "openInt": "82677"
}

取消订阅期权行情

功能说明

退订期权行情。

方法签名

func (c *PushClient) UnsubscribeOption(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.UnsubscribeOption([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

订阅期货行情

功能说明

订阅期货行情。

方法签名

func (c *PushClient) SubscribeFuture(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.SubscribeFuture([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

回调数据示例

{
    "symbol": "ESmain",
    "type": "BASIC",
    "timestamp": "1684766824130",
    "avgPrice": 4206.476,
    "latestPrice": 4202.5,
    "preClose": 4204.75,
    "volume": "557570",
    "open": 4189,
    "high": 4221.75,
    "low": 4186.5,
    "marketStatus": "Trading",
    "preSettlement": 4204.75,
    "minTick": 0.25
}

取消订阅期货行情

功能说明

退订期货行情。

方法签名

func (c *PushClient) UnsubscribeFuture(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.UnsubscribeFuture([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

订阅 K 线

功能说明

订阅 K 线。

方法签名

func (c *PushClient) SubscribeKline(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.SubscribeKline([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

回调数据示例

{
    "symbol": "AAPL",
    "time": "1712584560000",
    "open": 168.9779,
    "high": 169.0015,
    "low": 168.9752,
    "close": 169.0,
    "avg": 168.778,
    "volume": "3664",
    "count": 114,
    "amount": 617820.6508,
    "serverTimestamp": "1712584569746"
}

取消订阅 K 线

功能说明

退订 K 线。

方法签名

func (c *PushClient) UnsubscribeKline(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.UnsubscribeKline([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

订阅股票榜单

功能说明

订阅股票榜单行情。indicators 是 indicator 字符串列表（作为 symbols 字段传输）。

方法签名

func (c *PushClient) SubscribeStockTop(market string, indicators []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

参数类型必填SDK 默认值约束
marketstring是无市场代码；SDK 枚举值为 ALL/US/HK/CN/SG
indicators[]string是无排行榜指标字符串；SDK 原样传输且不校验枚举

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.SubscribeStockTop("US", []string{"LATEST_PRICE"}); err != nil {
	log.Fatal(err)
}

返回示例

回调数据示例

{
    "market": "US",
    "timestamp": "1687271010482",
    "topData": [
        {
            "targetName": "changeRate",
            "item": [
                {"symbol": "ICAD", "latestPrice": 1.63, "targetValue": 0.393162}
            ]
        },
        {
            "targetName": "volume",
            "item": [
                {"symbol": "TSLA", "latestPrice": 263.21, "targetValue": 40190416}
            ]
        }
    ]
}

取消订阅股票榜单

功能说明

退订股票榜单行情。

方法签名

func (c *PushClient) UnsubscribeStockTop(market string, indicators []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

参数类型必填SDK 默认值约束
marketstring是无市场代码；SDK 枚举值为 ALL/US/HK/CN/SG
indicators[]string是无排行榜指标字符串；SDK 原样传输且不校验枚举

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.UnsubscribeStockTop("US", []string{"LATEST_PRICE"}); err != nil {
	log.Fatal(err)
}

返回示例

订阅期权榜单

功能说明

订阅期权榜单行情。

方法签名

func (c *PushClient) SubscribeOptionTop(market string, indicators []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

参数类型必填SDK 默认值约束
marketstring是无市场代码；SDK 枚举值为 ALL/US/HK/CN/SG
indicators[]string是无排行榜指标字符串；SDK 原样传输且不校验枚举

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.SubscribeOptionTop("US", []string{"LATEST_PRICE"}); err != nil {
	log.Fatal(err)
}

返回示例

回调数据示例

{
    "market": "US",
    "timestamp": "1687277160445",
    "topData": [
        {
            "targetName": "volume",
            "item": [
                {
                    "symbol": "SPY",
                    "expiry": "20230620",
                    "strike": "435.0",
                    "right": "PUT",
                    "totalVolume": 212478
                }
            ]
        }
    ]
}

取消订阅期权榜单

功能说明

退订期权榜单行情。

方法签名

func (c *PushClient) UnsubscribeOptionTop(market string, indicators []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

参数类型必填SDK 默认值约束
marketstring是无市场代码；SDK 枚举值为 ALL/US/HK/CN/SG
indicators[]string是无排行榜指标字符串；SDK 原样传输且不校验枚举

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.UnsubscribeOptionTop("US", []string{"LATEST_PRICE"}); err != nil {
	log.Fatal(err)
}

返回示例

订阅数字货币行情

功能说明

订阅数字货币行情。

方法签名

func (c *PushClient) SubscribeCc(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.SubscribeCc([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

取消订阅数字货币行情

功能说明

退订数字货币行情。symbols 为空则退订全部。

方法签名

func (c *PushClient) UnsubscribeCc(symbols []string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.UnsubscribeCc([]string{"AAPL"}); err != nil {
	log.Fatal(err)
}

返回示例

订阅市场榜单

功能说明

订阅市场状态推送（dataType=Quote + market）。

方法签名

func (c *PushClient) SubscribeMarket(market string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.SubscribeMarket("US"); err != nil {
	log.Fatal(err)
}

返回示例

取消订阅市场榜单

功能说明

退订市场状态推送。

方法签名

func (c *PushClient) UnsubscribeMarket(market string) error

订阅/退订前必须成功 Connect。所需行情权限取决于标的和数据类型。

参数

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

返回

error；nil 表示消息已成功写入当前连接。

示例

if err := pc.UnsubscribeMarket("US"); err != nil {
	log.Fatal(err)
}

返回示例

Updated 8 days ago

Did this page help you?