可转债分笔订阅接口文档

获取 `tick_v1` WebSocket 票据;使用响应中的 `url` 连接 `/api/tick_stream_v1`,订阅可转债实时 Tick 增量。 `symbols` 使用带交易所后缀的完整代码;同一连接可混合订阅股票、ETF、可转债和指数。短代码按股票识别。 连接后从 ack 读取 `fields`,并

接口参数与返回字段速查

获取 `tick_v1` WebSocket 票据;使用响应中的 `url` 连接 `/api/tick_stream_v1`,订阅可转债实时 Tick 增量。

`symbols` 使用带交易所后缀的完整代码;同一连接可混合订阅股票、ETF、可转债和指数。短代码按股票识别。

连接后从 ack 读取 `fields`,并按该顺序解析 `items`。只推送订阅后的新行情,不发送初始快照。

请求参数

  • apikey(string,必选):猫爪数据 API Key。网页在线调试会为已登录用户自动注入,其他调用请从控制台获取。
  • channel(string(tick_stream),可选):实时推送通道,固定为 tick_stream。
  • symbols(array<string>,可选):连接后自动订阅的完整证券代码数组,可混合股票、ETF、可转债和指数;推荐包含市场后缀,短代码按股票规则推断;不支持快捷分组。本页示例为可转债。
  • ttl_seconds(integer,可选):票据有效期(秒),取值范围 30~600。
  • stream_version(string(tick_v1),可选):实时推送协议版本,固定为 tick_v1。

返回字段

  • channel(string):频道名
  • url(string):可直接连接的 tick_v1 WebSocket 地址,已包含 ticket 参数
  • expires_at(integer):票据过期时间(Unix 时间戳,秒)
  • ttl_seconds(integer):票据有效期(秒)
  • subscription_plan_code(string):本次连接使用的 tick 订阅套餐代码
  • tick_sub_limit(integer):本次连接对应套餐的 tick 订阅槽位上限
  • stream_version(string):实时分笔推送协议版本,固定为 tick_v1