快速入门

请求频率限制

长尾猴已开放沪深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 美国交易所(泛指纳斯达克,纽交所等)
  • 量化资讯

  • 为什么要选择量化交易系统来证券交易?
  • 新手如何建立量化交易策略?
  • 长尾猴量化用户服务协议?
技术支持
7552744
联系我们
VVTR@WLINNO.COM