长尾猴量化 API
  1. Tick行情(L1)-http/ws
  • 金融数据行情接口
    • 快速入门
    • 接口枚举值
    • 基础数据接口
      • 期货主力对应真实合约(CN)
      • 美股期权链
      • 获取symbol列表
    • 美股财务数据
      • 新闻
      • 财报
      • 曾用名
    • A股财务及市场数据
      • 股票基础信息
      • 指数成分股
      • 强势股
      • 复权因子
      • 板块代码查询
      • 板块成分股
      • 资金流向
      • 涨停榜
      • 跌停榜
      • 报表-年报季报
      • 报表-资产负债表
      • 报表-现金流量表
      • 报表-利润表
      • 财务-主要指标
      • 财务-估值指标
      • 财务-市值指标
    • 技术指标-http
      • 指标indicator
    • K线行情-http
      • 获取最新N条k线historyN
      • 获取历史k线history
    • Tick行情(L1)-http/ws
      • Tick实时订阅wss
      • 行情快照Snapshot
        GET
      • 最新K线Current
        GET
    • Trades行情(深度)-ws
      • A股、基金等返回结构
      • 期货返回结构
  • 数据模型
    • Schemas
      • key
      • BaseResponse
      • File
      • ResponseEntityFileSystemResource
      • HistoryOrder
      • BaseResponseString
      • InputStream
      • URI
      • ResponseEntityResource
      • UserPermissionRequest
      • UserPackage
      • UserPermissions
      • BaseResponseListUserPermissions
      • BasicBarVO
      • OrderItem
      • PageBasicBarVO
      • BaseResponsePageBasicBarVO
      • BaseResponseListBasicBarVO
      • SymbolInfoVO
      • BaseResponseListSymbolInfoVO
      • TickBasicInfoVO
      • BaseResponseListTickBasicInfoVO
      • FinancialVO
  1. Tick行情(L1)-http/ws

Tick实时订阅wss

接口说明#

协议类型: WebSocket
鉴权方式: API Key
连接限制: 每个 API Key 仅允许维持 1 个有效连接
心跳机制: 需每分钟向服务端发送 ping 字符串保活

订阅管理#

订阅规则#

📌 每次订阅会覆盖上一次的订阅列表
📌 单个连接最大支持同时订阅 100 个合约 或者 单个品种全部symbols(确认已开通权限)
📌 订阅成功后通过 WebSocket 连接持续接收盘口数据,仅盘中交易才推送,不含集合竞价
📌 如需订阅所有symbols,则在symbols参数处填入*

请求#

wss://rest.vvtr.com/v1/connect?apiKey=abcdefg

请求示例#

wss://rest.vvtr.com/v1/connect?apiKey=abcdefg&type=11&symbols=* 该请求示例*表示订阅全部A股
# Shell 示例(使用wscat工具)
wscat -c "wss://rest.vvtr.com/v1/connect?apiKey=abcdefg&type=11&symbols=*"

请求参数#

参数类型是否必填说明
apiKeystring是你的 apiKey
typestring是产品类型代码,多个产品类型用","隔开,如:11,22
symbolsstring是证券代码,多个用,分隔,"*"表示全部,同时订阅多个type时格式为:[a,b,c],[d,e,f],务必与type的顺序保持一致 。当type=14时,支持仅提交交易所代码(SHFE,INE,GFEX,DCE,CZCE,CFFEX)和主力,次主力,指数(9999,9998,8888)的形式,如 symbols=CZCE,8888

返回数据结构说明#

数据示例#

[
  {
    "s": "WH",
    "o": 0.0,
    "h": 0.0,
    "l": 0.0,
    "p": 3198.0,
    "cV": 0,
    "cA": 0.0,
    "cP": 0,
    "tt": 0,
    "lV": 0,
    "lA": 0.0,
    "cA": 1744009200000,
    "iopv": 0.0,
    "quotes": [
      {
        "bP": 0.0,
        "bV": 0,
        "aP": 0.0,
        "aV": 0
      }
    ]
  }
]

字段说明#

字段类型说明
sstringsymbol,证券代码
ofloatopen, 日线开盘价
hfloathigh,日线最高价
lfloatlow,日线最低价
pfloatprice,最新价(集合竞价成交前price为0)
cVlongcumVolume ,最新总成交量,累计值(日线成交量)
cAfloatcumAmount,最新总成交额,累计值 (日线成交金额)
cPintcumPosition , 合约持仓量(只适用于期货),累计值(股票此值为 0)
ttinttradeType,交易类型(只适用于期货) 1: '双开', 2: '双平', 3: '多开', 4: '空开', 5: '空平', 6: '多平', 7: '多换', 8: '空换'
lVintlastVolume , 最新瞬时成交量
lAfloatlastAmount,最新瞬时成交额(郑商所不支持)
q[] (list of dict)quotes, 股票提供买卖 5 档数据, list[0]~list[4]分别对应买卖一档到五档, 期货提供买卖 1 档数据, list[0]表示买卖一档;注意:可能会有买档或卖档报价缺失,比如跌停时无买档报价(bid_p 和 bid_v 为 0),涨停时无卖档报价(ask_p 和 ask_v 为 0); 其中每档报价quote结构如下:
iopvfloat基金份额参考净值,(只适用于基金)

quotes#

字段类型说明
bPfloatbidP,买价
bVintbidV,买量
aPfloataskP,卖价
aVintaskV,卖量

注意事项#

1.
🔔 连接保活:必须每分钟发送 ping 维持连接,超时自动断开
2.
⚠️ 覆盖机制:新订阅请求会完全替换当前订阅列表
3.
✅ 推荐做法:建议在建立连接后立即发送首次订阅请求
4.
🛑 错误处理:超过权限允许的订阅将返回错误码 4001
修改于 2026-03-31 07:51:27
上一页
获取历史k线history
下一页
行情快照Snapshot