长尾猴量化 API
  1. 金融数据行情接口
  • 金融数据行情接口
    • 快速入门
    • 接口枚举值
    • 基础数据接口
      • 期货主力对应真实合约(CN)
      • 美股期权链
      • 获取symbol列表
    • 美股财务数据
      • 新闻
      • 财报
      • 曾用名
    • A股财务及市场数据
      • 股票基础信息
      • 指数成分股
      • 强势股
      • 复权因子
      • 板块代码查询
      • 板块成分股
      • 资金流向
      • 涨停榜
      • 跌停榜
      • 报表-年报季报
      • 报表-资产负债表
      • 报表-现金流量表
      • 报表-利润表
      • 财务-主要指标
      • 财务-估值指标
      • 财务-市值指标
    • 技术指标-http
      • 指标indicator
    • K线行情-http
      • 获取最新N条k线historyN
      • 获取历史k线history
    • Tick行情(L1)-http/ws
      • Tick实时订阅wss
      • 行情快照Snapshot
      • 最新K线Current
    • 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. 金融数据行情接口

快速入门

基础URL：https://rest.vvtr.com/v1
鉴权方式：apiKey（在请求参数添加 apiKey=<your_token>）
响应格式：统一JSON格式
{
  "code": 200,
  "msg": "ok",
  "data": {...}
}

Http接口频率限制#

1次/每秒，无次数限制。控制好频率，多次超频apiKey会进入临时黑名单。

Websocket推送频率#

品种推送频率
A股、国内基金/指数/债券3秒
期货1秒
美股0.25秒
加密币0.25秒

AI 快速接入指南#

仅供 AI 阅读。只需看这一个文档即可完成接入。

基础信息#

基础URL: https://rest.vvtr.com/v1
鉴权: 请求参数添加 apiKey=<your_token>
响应格式:
{"code": 200, "msg": "ok", "data": {...}}

频率限制#

HTTP: 1次/秒（按apiKey），建议间隔 ≥ 1.5秒
WebSocket推送频率:
品种推送频率
A股/基金/债券/指数3秒
期货1秒
美股0.25秒
加密币0.25秒

type参数（全部）#

type市场说明
11A股沪深股票
12cn基金
13cn债券
14cn期货国内期货
16cn指数
21美股
22美股ETF
23美股期权2年内数据
24美期货CME
31外汇24小时
32加密货币24小时

一、用户菜单（权限分组）#

用户买哪些菜单决定能调哪些接口：
菜单名称数据类型HTTP接口WebSocket
K线接口实时+历史K线/kline/*-
L1tick接口实时快照/snapshot, /currentV1
trades深度接口逐笔成交-V2
财务数据A股/美股财务/stock/a/*, /stock/us/*-
指标技术指标/indicator-
先问用户买了哪个菜单，再调用对应接口。

二、时间格式（重要）#

所有品种查询24H内数据统一使用北京时间（UTC+8），不是美东时间。
查询目标from/to 格式
查询历史数据（当日之前）yyyy-mm-dd
查询实时数据（当日24H内）yyyy-mm-dd HH:mm:ss（北京时间）
# 美股示例（北京时间）
❌ 查询今日美股K线 ?from=2026-05-09 09:30:00  → 错误！这是美东时间
✅ 查询今日美股K线 ?from=2026-05-09 22:30:00  → 正确！换算成北京时间为 22:30
   （美东09:30 = 北京22:30，夏令时差13小时，冬令时差14小时）

# A股/期货示例（北京时间）
✅ 查询今日A股K线 ?from=2026-05-09 09:30:00  → 正常
✅ 查询今日期货K线 ?from=2026-05-09 21:00:00  → 正常（含夜盘）

# 历史数据（无时区要求）
✅ 查询历史K线 ?from=2026-01-01&to=2026-05-01  → 正常
实时K线 = 上一分钟已收盘的完整K线，不是当前正在形成的K线。

三、历史数据范围#

周期范围
日K及以上无限制
15分钟~日K2年内
1分钟~15分钟6个月内

四、K线接口#

GET /v1/kline/history     → 按时间范围（所有周期）
GET /v1/kline/historyn   → 最近N条（仅1m/15m）
GET /v1/kline/current    → 上一分钟完整K线
symbol参数：* = 全市场，指定时一般上限100只（可定制）。
/v1/kline/history?symbol=000001&type=11&from=2026-01-01&to=2026-05-01
/v1/kline/history?symbol=AAPL&type=21&from=2026-05-08 09:30:00&to=2026-05-08 15:00:00

五、实时快照#

GET /v1/snapshot  → 行情快照（价格、成交量等）
GET /v1/current   → 最新K线（上一分钟收盘）
symbol参数：上限100只（可定制）。

六、symbol列表#

必须通过接口获取，不要猜测格式！
GET /v1/symbols?type=XX

示例:
/v1/symbols?type=11   → A股symbol列表
/v1/symbols?type=14   → 期货symbol列表（包含交易所映射）
/v1/symbols?type=21   → 美股symbol列表
/v1/symbols?type=22   → 美股ETF列表
/v1/symbols?type=24   → 美期货symbol列表
让用户从返回列表中选择symbol。

六点五、symbol长度限制#

除财务接口外，其余接口均有symbol长度限制：
接口symbol参数限制
/kline/** = 全市场，指定时传逗号分隔默认100只，可定制
/snapshot、/current逗号分隔默认100只，可定制
WebSocket数组默认100只，可定制
/indicator逗号分隔默认100只，可定制
/Ochainticker（仅单个标的）无限制
/realSymbol仅单个合约无限制
/stock/a/*、/stock/us/*财务接口无限制
* 表示全市场，但实际能查多少取决于用户套餐授权数量。

七、WebSocket#

/v1/connect  → L1快照/当前K线（type=11/12/13/16）
/v2/connect  → 逐笔成交（实时推送）
连接后发送: {"symbols":["AAPL"],"type":21}
symbol参数：上限100只（可定制）。

八、期货主力合约#

GET /v1/realSymbol?symbol=IF&type=14
symbol参数：仅查单个合约。

九、期权链#

GET /v1/Ochain
参数: ticker（标的代码）, from, to, expired（是否包含过期期权）
symbol参数（ticker）：无限制（仅查单个标的）。

十、技术指标#

GET /v1/indicator
参数: symbol, type, indicators
symbol参数：上限100只（可定制）。

十一、A股财务接口 （type=11）#

接口说明
/v1/stock/a/basic股票基础信息
/v1/stock/a/indexConstituents指数成分股
/v1/stock/a/strongRising强势股
/v1/stock/a/adjustment复权因子
/v1/stock/a/sectionCode板块代码
/v1/stock/a/sectorStock板块成分股
/v1/stock/a/fundflow资金流向
/v1/stock/a/limitUp涨停榜
/v1/stock/a/limitDown跌停榜
/v1/stock/a/period年报季报
/v1/stock/a/balance资产负债表
/v1/stock/a/cash现金流量表
/v1/stock/a/profit利润表
/v1/stock/a/financial/index主要指标
/v1/stock/a/financial/valuation估值指标
/v1/stock/a/financial/mktcap市值指标

十二、美股财务接口（type=21/22）#

接口说明
/v1/stock/us/financial财报数据
/v1/stock/us/news新闻数据
/v1/stock/us/formername历史名称

十三、403错误处理#

1.
/v1/symbols 403 → API Key无效
2.
对应接口403 → 用户没买该菜单
3.
期货接口403 → 用户没买对应交易所权限

十四、获取时机与重试#

K线数据写入有延迟，建议从整分钟后第5秒开始获取
获取失败：等待2秒重试，仍失败等4秒，最多3次
同一时间点数据不要重复获取，缓存在本地

调用流程#

接入用户前，必须先问清楚以下信息，缺一不可：
1.
API Key — 每个用户唯一，先拿到才能调接口
2.
套餐菜单 — K线 / L1tick / trades深度 / 财务 / 指标
3.
查询数量上限 — 问清楚单次可查多少只股票（默认100，可定制）
4.
查询需求 — 想查哪些股票？查什么数据？
接入示例（美股K线）：

✅ 完整流程：
用户：我要接入美股K线
我：请问您的API Key是什么？单次查询上限是多少只？
用户：xxx，上限100只
我：好的。您想查哪几只美股？
用户：AAPL、TSLA、NVDA
我：好的，开始为您查询...

❌ 缺失流程（错误示例）：
我：请问您要查哪只股票？
用户：AAPL
我：好的（直接开始调接口 → 没有API Key调不了）
修改于 2026-05-12 13:11:04
下一页
接口枚举值