获取 `tick_v1` WebSocket 票据；使用响应中的 `url` 连接 `/api/tick_stream_v1`，订阅 ETF 实时 Tick 增量。 `symbols` 使用带交易所后缀的完整代码；同一连接可混合订阅股票、ETF、可转债和指数。短代码按股票识别。 连接后从 ack 读取 `fields`，并按该顺序解析 `items`。只推送订阅后的新行情，不发送初始快照。
POST
/api/v2/realtime/ws-ticketapiname:etf/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。 |
symbols | array<string> | 可选 | ["510300.SH","159915.SZ"] | 连接后自动订阅的完整证券代码数组，可混合股票、ETF、可转债和指数；推荐包含市场后缀，短代码按股票规则推断；不支持快捷分组。本页示例为 ETF。 |
ttl_seconds | integer | 可选 | 120 | 票据有效期（秒），取值范围 30～600。 |
stream_version | string（tick_v1） | 可选 | tick_v1 | 实时推送协议版本，固定为 tick_v1。 |
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": [
"510300.SH",
"159915.SZ"
],
"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"
}
}