行情订阅

以下签名直接来自 PushClient.cs。除连接和状态方法外，订阅调用返回 uint 请求 ID；最终结果由回调异步确认。

订阅股票行情

操作名

PushClient.SubscribeQuote. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint SubscribeQuote(ISet<string> symbols)

参数

symbols 必须实现 ISet 泛型接口（元素为 string）；取消方法传 null 表示取消该主题全部代码。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.SubscribeQuote(new HashSet<string> { "AAPL" });

响应类型

// 实际完成回调
SubscribeEnd(int, string, string)

回调数据示例

基本行情（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"
}

取消订阅股票行情

操作名

PushClient.CancelSubscribeQuote. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint CancelSubscribeQuote(ISet<string>? symbols = null)

参数

symbols 必须实现 ISet 泛型接口（元素为 string）；取消方法传 null 表示取消该主题全部代码。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.CancelSubscribeQuote(new HashSet<string> { "AAPL" });

响应类型

// 实际完成回调
CancelSubscribeEnd(int, string, string)

订阅逐笔成交

操作名

PushClient.SubscribeTradeTick. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint SubscribeTradeTick(ISet<string> symbols)

参数

symbols 必须实现 ISet 泛型接口（元素为 string）；取消方法传 null 表示取消该主题全部代码。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.SubscribeTradeTick(new HashSet<string> { "AAPL" });

响应类型

// 实际完成回调
SubscribeEnd(int, string, string)

回调数据示例

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

取消订阅逐笔成交

操作名

PushClient.CancelSubscribeTradeTick. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint CancelSubscribeTradeTick(ISet<string>? symbols = null)

参数

symbols 必须实现 ISet 泛型接口（元素为 string）；取消方法传 null 表示取消该主题全部代码。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.CancelSubscribeTradeTick(new HashSet<string> { "AAPL" });

响应类型

// 实际完成回调
CancelSubscribeEnd(int, string, string)

订阅期权行情

操作名

PushClient.SubscribeOption. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint SubscribeOption(ISet<string> symbols)

参数

symbols 必须实现 ISet 泛型接口（元素为 string）；取消方法传 null 表示取消该主题全部代码。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.SubscribeOption(new HashSet<string> { "AAPL  260821C00200000" });

响应类型

// 实际完成回调
SubscribeEnd(int, string, string)

回调数据示例

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

取消订阅期权行情

操作名

PushClient.CancelSubscribeOption. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint CancelSubscribeOption(ISet<string>? symbols = null)

参数

symbols 必须实现 ISet 泛型接口（元素为 string）；取消方法传 null 表示取消该主题全部代码。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.CancelSubscribeOption(new HashSet<string> { "AAPL  260821C00200000" });

响应类型

// 实际完成回调
CancelSubscribeEnd(int, string, string)

订阅期货行情

操作名

PushClient.SubscribeFuture. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint SubscribeFuture(ISet<string> symbols)

参数

symbols 必须实现 ISet 泛型接口（元素为 string）；取消方法传 null 表示取消该主题全部代码。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.SubscribeFuture(new HashSet<string> { "ES2609" });

响应类型

// 实际完成回调
SubscribeEnd(int, string, string)

回调数据示例

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

取消订阅期货行情

操作名

PushClient.CancelSubscribeFuture. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint CancelSubscribeFuture(ISet<string>? symbols = null)

参数

symbols 必须实现 ISet 泛型接口（元素为 string）；取消方法传 null 表示取消该主题全部代码。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.CancelSubscribeFuture(new HashSet<string> { "ES2609" });

响应类型

// 实际完成回调
CancelSubscribeEnd(int, string, string)

订阅深度行情

操作名

PushClient.SubscribeDepthQuote. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint SubscribeDepthQuote(ISet<string> symbols)

参数

symbols 必须实现 ISet 泛型接口（元素为 string）；取消方法传 null 表示取消该主题全部代码。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.SubscribeDepthQuote(new HashSet<string> { "AAPL" });

响应类型

// 实际完成回调
SubscribeEnd(int, string, string)

回调数据示例

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

取消订阅深度行情

操作名

PushClient.CancelSubscribeDepthQuote. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint CancelSubscribeDepthQuote(ISet<string>? symbols = null)

参数

symbols 必须实现 ISet 泛型接口（元素为 string）；取消方法传 null 表示取消该主题全部代码。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.CancelSubscribeDepthQuote(new HashSet<string> { "AAPL" });

响应类型

// 实际完成回调
CancelSubscribeEnd(int, string, string)

订阅 K 线

操作名

PushClient.SubscribeKline. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint SubscribeKline(ISet<string> symbols)

参数

symbols 必须实现 ISet 泛型接口（元素为 string）；取消方法传 null 表示取消该主题全部代码。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.SubscribeKline(new HashSet<string> { "AAPL" });

响应类型

// 实际完成回调
SubscribeEnd(int, string, string)

回调数据示例

{
    "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 线

操作名

PushClient.CancelSubscribeKline. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint CancelSubscribeKline(ISet<string>? symbols = null)

参数

symbols 必须实现 ISet 泛型接口（元素为 string）；取消方法传 null 表示取消该主题全部代码。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.CancelSubscribeKline(new HashSet<string> { "AAPL" });

响应类型

// 实际完成回调
CancelSubscribeEnd(int, string, string)

订阅整体市场行情

操作名

PushClient.SubscribeMarketQuote. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint SubscribeMarketQuote(Market market, QuoteSubject subject)

参数

market 与 QuoteSubject 必填；主题必须与取消命令匹配。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.SubscribeMarketQuote(Market.US, QuoteSubject.Quote);

响应类型

// 实际完成回调
SubscribeEnd(int, string, string)

取消订阅整体市场行情

操作名

PushClient.CancelSubscribeMarketQuote. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint CancelSubscribeMarketQuote(Market market, QuoteSubject subject)

参数

market 与 QuoteSubject 必填；主题必须与取消命令匹配。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.CancelSubscribeMarketQuote(Market.US, QuoteSubject.Quote);

响应类型

// 实际完成回调
CancelSubscribeEnd(int, string, string)

订阅股票榜单

操作名

PushClient.SubscribeStockTop. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint SubscribeStockTop(Market market, ISet<Indicator>? indicators = null)

参数

market 必填；indicators 可为 null，非 null 时转换为指标名称集合。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.SubscribeStockTop(Market.US);

响应类型

// 实际完成回调
SubscribeEnd(int, string, string)

回调数据示例

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

取消订阅股票榜单

操作名

PushClient.CancelSubscribeStockTop. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint CancelSubscribeStockTop(Market market, ISet<Indicator>? indicators = null)

参数

market 必填；indicators 可为 null，非 null 时转换为指标名称集合。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.CancelSubscribeStockTop(Market.US);

响应类型

// 实际完成回调
CancelSubscribeEnd(int, string, string)

订阅期权行情 Top

操作名

PushClient.SubscribeOptionTop. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint SubscribeOptionTop(Market market, ISet<Indicator>? indicators = null)

参数

market 必填；indicators 可为 null，非 null 时转换为指标名称集合。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.SubscribeOptionTop(Market.US);

响应类型

// 实际完成回调
SubscribeEnd(int, string, string)

回调数据示例

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

取消订阅期权行情 Top

操作名

PushClient.CancelSubscribeOptionTop. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint CancelSubscribeOptionTop(Market market, ISet<Indicator>? indicators = null)

参数

market 必填；indicators 可为 null，非 null 时转换为指标名称集合。

Return: uint request ID. 订阅结果进入 SubscribeEnd；取消结果进入 CancelSubscribeEnd。

示例

uint requestId = client.CancelSubscribeOptionTop(Market.US);

响应类型

// 实际完成回调
CancelSubscribeEnd(int, string, string)

查询已订阅标的

操作名

PushClient.GetSubscribedSymbols. 已连接通道上的订阅、取消订阅或订阅状态查询命令。发送成功不等于服务端确认成功。

请求

uint GetSubscribedSymbols()

参数

无参数；查询当前连接的行情代码订阅集合。

Return: uint request ID. 结果进入 GetSubscribedSymbolEnd。

示例

uint requestId = client.GetSubscribedSymbols();

响应类型

// 实际完成回调
GetSubscribedSymbolEnd(SubscribedSymbol)