获取 `tick_v1` WebSocket 票据，用于订阅股票、ETF、可转债和指数的实时 Tick 增量。
POST
/api/v2/realtime/ws-ticketapiname:stock/tick_stream_v1生产专线（默认）深圳
http://sz.numcat.net:8866/api/v2/realtime/ws-ticket上海http://sh.numcat.net:8866/api/v2/realtime/ws-ticket公网备用https://numcat.net/api/v2/realtime/ws-ticket请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
apikey | string | 必选 | — | 猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。 |
channel | string（tick_stream） | 可选 | tick_stream | 实时推送通道，固定为 tick_stream。 |
stream_version | string（tick_v1） | 可选 | tick_v1 | 实时推送协议版本，固定为 tick_v1。 |
symbols | array<string> | 可选 | ["600519.SH","510300.SH","113699.SH","000300.SH"] | 连接后自动订阅的四资产完整代码数组；股票代码也可使用快捷股票池标识。 |
groups | array<string> | 可选 | [] | 连接后自动订阅的股票快捷组，仅适用于股票；展开后的真实股票数计入订阅额度。支持：`@ALL_A`=全部在市 A 股；`@SH`=上海市场在市股票；`@SZ`=深圳市场在市股票；`@BJ`=北京市场在市股票；`@MAIN`=沪深主板；`@CYB`=创业板；`@KCB`=科创板；`@ST`=名称含 ST 的在市股票；`@HS300`=沪深 300 最新成份股；`@ZZ500`=中证 500 最新成份股；`@ZZ1000`=中证 1000 最新成份股；`@SZ50`=上证 50 最新成份股；`@CYB50`=创业板 50 最新成份股。代码不区分大小写，`@` 可省略。 |
ttl_seconds | integer | 可选 | 120 | 票据有效期（秒），取值范围 30～600。 |
fields 返回字段
字段顺序与接口样例保持一致| 字段 | 类型 | 名称 | 示例值 | 描述 |
|---|---|---|---|---|
channel | string | — | tick_stream | 频道名 |
url | string | — | wss://pre.numcat.net/api/tick_stream_v1?ticket={ticket} | 可直接连接的 tick_v1 WebSocket 地址，已包含 ticket 参数 |
expires_at | integer | — | 1740800000 | 票据过期时间（Unix 时间戳，秒） |
ttl_seconds | integer | — | 120 | 票据有效期（秒） |
subscription_plan_code | string | — | professional_year | 本次连接使用的 tick 订阅套餐代码 |
tick_sub_limit | integer | — | 6000 | 本次连接对应套餐的 tick 订阅槽位上限 |
stream_version | string | — | tick_v1 | 实时分笔推送协议版本，固定为 tick_v1 |
请求与响应样例
固定样例
{
"apikey": "YOUR_API_KEY",
"channel": "tick_stream",
"stream_version": "tick_v1",
"symbols": [
"600519.SH",
"510300.SH",
"113699.SH",
"000300.SH"
],
"ttl_seconds": 120
}{
"code": 200,
"message": "success",
"data": {
"channel": "tick_stream",
"url": "wss://pre.numcat.net/api/tick_stream_v1?ticket={ticket}",
"expires_at": 1740800000,
"ttl_seconds": 120,
"subscription_plan_code": "professional_year",
"tick_sub_limit": 6000,
"stream_version": "tick_v1"
}
}