快速入门
请求频率限制
长尾猴已开放沪深A股,商品期货,港股,美股及期权等历史及实时行情接口(部分接口陆续添加中),登录后台获取行情apiKey即可免费调用行情接口,如果要提升权限及频率则需要付费购买行情,频率限制参考下表。
品种 | 查询频率及周期上限(免费) | 查询频率及周期上限(付费) |
---|---|---|
市场股票列表 | 1次/分钟,当日 | 1次/分钟,当日 |
A股/美股 历史K线 | 3次/分钟,分钟K线7日,其它粒度一个月 | 60次/分钟,A股最长15年,美股5年 |
A股/美股 实时价格 | 1次/分钟,延时15分钟 | 3秒间隔,实时 |
美股期权 实时价格 | 1次/分钟,延时15分钟 | 间隔3秒,实时 |
美股期权链 | 1次/分钟,2年内 | 60次/分钟,2年内 |
请求限制 | 免费接口 | 付费接口 |
单次请求股票数 | 1支股票 | 30支股票 |
单次请求数据量 | 100条 | 2000条 |
注意,请勿高频向接口发起请求,否则apiKey可能会被临时或永久封禁。
返回结构
所有接口返回统一结构
字段 | 类型 | 描述 |
---|---|---|
code | int | 返回码,0 表示成功 |
msg | string | 消息,接口错误时有值 |
data | [object,array] | 返回数据,具体接口返回的对象或对象数组 |
返回类型
所有接口返回 JSON 格式
历史数据说明
由于历史行情数据量较大,根据不同市场我们尽可能缓存足够时间,超过日期则删除。所有历史K线一律为前复权,最长存储时间请参考下表。
K线粒度 | A股 | 美股 | 美股期权 |
---|---|---|---|
1分钟 | 最近3个月 | 5年 | 2年 |
15分钟 | -- | 5年 | -- |
日K | 15年 | 5年 | -- |
获取股票代码列表
请求频率 1次/分钟
GET http://quote.vvtr.com/symbols
请求
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
market | string | 是 | 市场类型 enum.MARKET |
返回
字段 | 类型 | 描述 |
---|---|---|
symbol | string | 股票代码, 如 AAPL |
exchage | string | 交易所 enum.Exchange |
name | string | 股票名称 |
示例
http://quote.vvtr.com/symbols?market=SMART
获取股票K线数据
请求频率 60次/分钟
可获取当日盘中及历史K线,注意A股在盘中获取当日分钟K线时会延时40s,其它市场无延迟。
GET http://quote.vvtr.com/stock/kline
请求
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
symbol | string | 是 | 股票代码, 如 AAPL |
exchage | string | 是 | 交易所 enum.Exchange |
interval | string | 是 | K线类型 enum.Interval,美股:[1m,15m,1d] A股:[1m,1d] |
from | int | 是 | 开始时间 毫秒时间戳,如 1639371600000 |
to | int | 是 | 结束时间 毫秒时间戳,如 1639371600000 |
limit | int | 否 | 不超过2000条 |
返回
字段 | 类型 | 描述 |
---|---|---|
open | float | 开盘价 |
high | float | 最高价 |
low | int | 最低价 |
close | int | 收盘价 |
volume | int | 成交量 |
turnover | int | 成交额 |
avg_price | int | 成交量加权均价,仅1m粒度有值 |
time | int | 毫秒时间戳,如 1639371600000 |
示例
http://quote.vvtr.com/stock/kline?symbol=AAPL&exchange=SMART&interval=1m&from=11111&to=11111&limit=500
获取股票实时价格
请求频率 每3秒请求一次
GET http://quote.vvtr.com/stock/briefs
请求
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
symbols | string | 是 | 股票代码,支持批量查询,用逗号分割,每次最多50个 |
exchage | string | 是 | 交易所 enum.Exchange |
返回
字段 | 类型 | 描述 |
---|---|---|
symbol | string | 股票代码, 如 AAPL |
latest_price | float | 最新价 |
pre_price | float | 前收价 |
time | int | 最新更新时间,毫秒时间戳,如 1639371600000 |
示例
http://quote.vvtr.com/stock/briefs?symbols=AAPL,TSLA&exchange=SMART
获取期权K线数据
请求频率 60次/分钟
GET http://quote.vvtr.com/option/kline
获取单天的期权1分钟k线
请求
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
identifier | string | 是 | 期权代码 |
exchage | string | 是 | 交易所 enum.Exchange |
date | int | 是 | 日期或时间,毫秒时间戳,如 1639371600000;为日期时返回当天的所有1分钟k数据,为分钟时返回该分钟k数据 |
返回
字段 | 类型 | 描述 |
---|---|---|
open | float | 开盘价 |
high | float | 最高价 |
low | int | 最低价 |
close | int | 收盘价 |
volume | int | 成交量 |
turnover | int | 成交额 |
time | int | 毫秒时间戳,如 1639371600000 |
示例
http://quote.vvtr.com/option/kline?identifier=AAPL230317C000135000,AAPL230721C00110000&exchange=SMART&date=1639371600000
获取期权链
请求频率 60次/分钟
GET http://quote.vvtr.com/option/chain
查询接口返回离正股价最近的上下各15个行权价对应的期权数据。
请求
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
symbol | string | 是 | 股票代码 |
exchage | string | 是 | 交易所 enum.Exchange |
expiration_date | int | 是 | 过期日期 |
strike_price | float | 否 | 行权价 |
right | string | 否 | 方向 ["put","call"] |
query_date | int | 否 | 查询日期 默认查询当前日期,当查询历史日期时返回系统根据现有期权数据模拟生成的历史期权列表 |
返回
字段 | 类型 | 描述 |
---|---|---|
identifier | string | 期权代码 |
symbol | string | 股票代码 |
expiration_date | int | 过期日期 |
strike_price | float | 行权价 |
right | string | 方向 ["put","call"] |
latest_price | float | 最新价 默认查询当前日期时才有值,当查询历史日期时为0 |
示例
http://quote.vvtr.com/option/chain?symbol=AAPL&exchange=SMART&strike_price=400&expiration_date=1639371600000&right=put&query_date=
获取期权实时价格
请求频率 每3秒请求一次
GET http://quote.vvtr.com/option/briefs
请求
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
identifiers | string | 是 | 期权代码,支持批量查询,用逗号分割,每次最多50个 |
exchage | string | 是 | 交易所 enum.Exchange |
返回
字段 | 类型 | 描述 |
---|---|---|
identifier | string | 股票代码, 如 AAPL |
latest_price | float | 最新价 |
time | int | 最新成交时间,毫秒时间戳,如 1639371600000 |
示例
http://quote.vvtr.com/option/briefs?symbols=AAPL230317C000135000,AAPL230721C00110000&exchange=SMART
错误处理
返回码和描述信息 对应公共响应参数中的code和message,用来描述业务请求的结果,对应说明如下:
code | message | 描述 |
---|---|---|
0 | success | 请求成功 |
1 | rate limit | 请求频率超过限制 |
2 | access denied | 拒绝访问 |
3 | param error | 请求参数错误 |
4 | permission denied | 访问权限不足,授权码过期或者错误 |
4 | permission denied | 访问权限不足,授权码过期或者错误 |
枚举值
Interval
标识 | K线类型 |
---|---|
1m | 1分钟 |
15m | 15分钟 |
1d | 1天 |
Market
标识 | 市场 |
---|---|
ALL | 全部 |
US | 美股 |
HK | 港股 |
CN | A股 |
Exchange
标识 | 交易所 |
---|---|
SSE | 上交所 |
SZSE | 深交所 |
SEHK | 港交所 |
SMART | 美国交易所(泛指纳斯达克,纽交所等) |