在金融数据分析和股票市场研究中,获取准确的历史数据是至关重要的。**万维易源提供的“股票历史数据分析查询”API为开发者和金融分析师提供了一个高效、便捷的工具,可根据股票代码、日期获取股票历史数据及相关分析,**返回日期、开盘价、收盘价、最高价、最低价、成交量、成交额、换手率、涨跌幅等,可绘制相应日线图及走势分析 。本文将详细介绍如何使用该API,以及其核心功能和调用方法。
一、API概述
1. 接入点说明(以“股票历史日线数据查询”为例)
- 数据范围:目前可以查询沪深股市的复权日K线,单次查询最大日期跨度为一个季度。
- 更新频率:交易日收盘后20-30分钟更新当日历史数据。
2. 接口地址
https://route.showapi.com/131-47?appKey={your_appKey}
请将 {your_appKey}
替换为你在万维易源平台申请的个人 appKey
。
二、请求参数
以下是提交股票历史日线数据查询任务所需的请求参数:
参数名称 | 类型 | 示例值 | 必须 | 描述 |
---|---|---|---|---|
begin | String | 2016-09-01 | 是 | 开始日期,格式为 yyyy-MM-dd ,最早到 2000-01-01 。 |
end | String | 2016-09-02 | 是 | 结束日期,格式为 yyyy-MM-dd ,单次查询最大日期跨度为一个季度。 |
code | String | 600004 | 是 | 股票编码,不需要写市场名。 |
type | String | bfq | 否 | K线数据复权类型:qfq 代表“前复权”hfq 代表“后复权”bfq 代表“不复权”默认值为 bfq ,港股数据暂时只有不复权的。 |
三、返回参数
以下是接口返回的参数及其描述:
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
list | Object[] | (历史记录的列表) | 历史记录的列表。 |
- close_price | String | 13.82 | 收盘价。 |
- code | String | 600004 | 股票代码。 |
- date | String | 2016-09-02 | 日期,例如 2016-09-02 。 |
- market | String | sh | 市场,例如 sh 。 |
- max_price | String | 13.90 | 最高价。 |
- min_price | String | 13.73 | 最低价。 |
- open_price | String | 13.81 | 开盘价。 |
- stockName | String | 白云机场 | 股票名称。 |
- trade_money | String | 56480000 | 交易金额(元)。 |
- trade_num | String | 40861 | 交易手数。 |
- diff_money | String | 0.01 | 涨跌额。 |
- swing | String | 1.23 | 振幅。 |
- diff_rate | String | 0.07 | 涨跌幅。 |
- turnover | String | 0.03 | 换手率。 |
ret_code | String | 0 | 返回代码:0 表示成功,其他表示失败。 |
四、调用示例
以下是一个使用 curl
命令调用该接口的示例:
curl 'https://route.showapi.com/131-47?appKey=your_appKey' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'type=bfq' \
-d 'code=600004' \
-d 'end=2016-09-02' \
-d 'begin=2016-09-01'
请将 your_appKey
替换为你在万维易源平台申请的 appKey
。
五、返回示例
以下是接口返回的JSON示例:
{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_id": "ce135f6739294c63be0c021b76b6fbff",
"showapi_res_body": {
"ret_code": 0,
"list": [
{
"stockName": "白云机场",
"trade_money": "56480000",
"diff_money": "0.01",
"open_price": "13.81",
"code": "600004",
"date": "2016-09-02",
"min_price": "13.73",
"market": "sh",
"trade_num": "40861",
"close_price": "13.82",
"max_price": "13.90",
"swing": "1.23",
"diff_rate": "0.07",
"turnover": "0.03"
}
]
}
}
六、获取 appKey
要获取 appKey
,请访问万维易源的控制台页面:
查看 appKey
七、总结
万维易源的“股票历史数据分析查询”API为开发者和金融分析师提供了一个高效、便捷的工具,可以通过简单的接口调用查询股票历史数据及相关分析,返回日期、开盘价、收盘价、最高价、最低价、成交量、成交额、换手率、涨跌幅等,可绘制相应日线图及走势分析 。适用于金融数据分析、股票市场研究等多种场景。希望本文能帮助你更好地了解和使用该API。如果你有任何问题或需要进一步的帮助,请随时访问万维易源的官方文档或联系技术支持。