基础URL：https://rest.vvtr.com/v1

鉴权方式：apiKey（在请求参数添加 apiKey=<your_token>）

响应格式：统一JSON格式

{
  "code": 200,
  "msg": "ok",
  "data": {...}
}

接口频率限制

http: 1次/每秒，无次数限制，控制好频率，多次超频apiKey会进入临时黑名单。
websocket:L1 tick通常为3秒推送一次,深度行情则为实时推送。

AI 快速接入指南

仅供 AI 阅读，请将本文链接给AI，AI可以快速接入。

1. 先向用户索要信息

只问这三项：

mobile

apikey

用户想查什么，例如：期货实时行情、美股K线、A股财务、技术指标

可直接这样问：

请提供手机号和 apikey，并告诉我要查什么数据，例如：期货实时行情、A股K线、美股财报。

用户不知道 symbol 时，不要让用户自己猜代码。先查 /v1/symbols，再让用户从结果里选，或根据用户输入的中文名称/常见代码做匹配。

2. 查询权限

读取：

data.owned_api_groups[].apis[]：可调用接口，只能调用这里返回的接口。

data.active_packages[].market_code：接口参数 type。

data.active_packages[].limit：symbols 单次提交上限，超过必须拆批。

如果 active_packages 为空，只能调用基础数据接口。

3. 调接口

所有 HTTP 接口追加 apikey={apikey}。

先调用 /v1/symbols?type={type}&apikey={apikey} 获取合法 symbol。

根据用户需求，在 owned_api_groups[].apis[] 里选择对应接口。

不调用 owned_api_groups 未返回的接口。

具体接口参数和返回结构读取：https://doc.vvtr.com/474766424e0

4. 时间参数

查询今日之前历史数据：from/to=yyyy-mm-dd

查询最近 24H 数据：from/to=yyyy-mm-dd HH:mm:ss

最近 24H 数据统一用北京时间 UTC+8，不用美东时间。

用户没说时间范围时，先问清楚，不要自行假设。

5. 频率

HTTP：1 次/秒，建议请求间隔 >= 1.5 秒。

K线数据建议整分钟后第 5 秒再取。

失败重试：等 2 秒，再失败等 4 秒，最多 3 次。

同一时间点数据本地缓存，不重复请求。

6. 推荐执行顺序

问用户要 mobile、apikey、查询需求。

调 /v1/my/permissions。

判断可用接口、type、limit。

调 /v1/symbols 获取合法 symbol。

如 symbol 数量超过 limit，拆批。

读取接口文档，按对应接口参数发起请求。

将结果整理成用户能看懂的中文说明。

快速入门

接口频率限制#

AI 快速接入指南#

1. 先向用户索要信息#

2. 查询权限#

3. 调接口#

4. 时间参数#

5. 频率#

6. 推荐执行顺序#