Documentation Index
Fetch the complete documentation index at: https://docs.alphafin.x-pai.com/llms.txt
Use this file to discover all available pages before exploring further.
日线行情数据
获取A股市场股票和指数的日线行情数据,包括开盘价、收盘价、最高价、最低价、成交量等信息。
接口说明
HTTP请求
请求参数
| 参数名 | 类型 | 必选 | 描述 |
|---|
symbol | 字符串 | 是 | 股票或指数代码,可以是单个代码或以逗号分隔的多个代码(最多50个)。支持多种格式,如600519、sh.600519或600519.SH。 |
begin_date | 字符串 | 否 | 起始日期,格式为YYYY-MM-DD。如果未指定,默认为最近一个交易日前30个交易日。 |
end_date | 字符串 | 否 | 结束日期,格式为YYYY-MM-DD。如果未指定,默认为最近一个交易日。 |
adjusted | 布尔值 | 否 | 是否返回前复权数据。true表示返回前复权数据(默认),false表示返回未复权数据。 |
fields | 字符串 | 否 | 指定返回字段,用逗号分隔。如果未指定,返回所有可用字段。 |
limit | 整数 | 否 | 返回的数据条数限制,默认为最近一年的交易日数量(约为250天)。 |
返回字段
| 字段名 | 类型 | 描述 |
|---|
symbol | 字符串 | 股票或指数代码 |
name | 字符串 | 股票或指数名称 |
daily | 数组 | 日线数据数组,按日期降序排列 |
每个日线数据项包含以下字段:
| 字段名 | 类型 | 描述 |
|---|
date | 字符串 | 交易日期,格式为YYYY-MM-DD |
open | 数值 | 开盘价 |
high | 数值 | 最高价 |
low | 数值 | 最低价 |
close | 数值 | 收盘价 |
pre_close | 数值 | 前收盘价 |
change | 数值 | 涨跌额 |
pct_change | 数值 | 涨跌幅(%) |
volume | 整数 | 成交量(手) |
amount | 数值 | 成交金额(元) |
turnover | 数值 | 换手率(%) |
adj_factor | 数值 | 复权因子,仅在adjusted=false时返回 |
请求示例
获取单个股票的日线数据
curl -X GET "https://api.alphafin.x-pai.com/v1/market/daily?symbol=600519&begin_date=2023-01-01&end_date=2023-01-31" \
-H "X-API-KEY: your_api_key_here"
获取多个股票的日线数据
curl -X GET "https://api.alphafin.x-pai.com/v1/market/daily?symbol=600519,000858&begin_date=2023-01-01&end_date=2023-01-10" \
-H "X-API-KEY: your_api_key_here"
获取未复权数据
curl -X GET "https://api.alphafin.x-pai.com/v1/market/daily?symbol=600519&begin_date=2023-01-01&end_date=2023-01-31&adjusted=false" \
-H "X-API-KEY: your_api_key_here"
获取指定字段
curl -X GET "https://api.alphafin.x-pai.com/v1/market/daily?symbol=600519&begin_date=2023-01-01&end_date=2023-01-31&fields=date,open,high,low,close,volume" \
-H "X-API-KEY: your_api_key_here"
响应示例
单个股票响应
{
"code": 200,
"message": "success",
"data": {
"symbol": "600519",
"name": "贵州茅台",
"daily": [
{
"date": "2023-01-31",
"open": 1726.40,
"high": 1746.00,
"low": 1720.00,
"close": 1740.00,
"pre_close": 1725.00,
"change": 15.00,
"pct_change": 0.87,
"volume": 2231600,
"amount": 3868984200.00,
"turnover": 0.18
},
{
"date": "2023-01-30",
"open": 1718.00,
"high": 1738.88,
"low": 1712.00,
"close": 1725.00,
"pre_close": 1730.00,
"change": -5.00,
"pct_change": -0.29,
"volume": 2425600,
"amount": 4184761600.00,
"turnover": 0.19
},
// 更多日期的数据...
]
}
}
多个股票响应
{
"code": 200,
"message": "success",
"data": [
{
"symbol": "600519",
"name": "贵州茅台",
"daily": [
{
"date": "2023-01-10",
"open": 1680.00,
"high": 1688.00,
"low": 1655.62,
"close": 1658.00,
"pre_close": 1675.00,
"change": -17.00,
"pct_change": -1.01,
"volume": 3051100,
"amount": 5104992300.00,
"turnover": 0.24
},
// 更多日期的数据...
]
},
{
"symbol": "000858",
"name": "五粮液",
"daily": [
{
"date": "2023-01-10",
"open": 168.20,
"high": 169.99,
"low": 166.10,
"close": 167.00,
"pre_close": 167.36,
"change": -0.36,
"pct_change": -0.22,
"volume": 6384600,
"amount": 1074257900.00,
"turnover": 0.16
},
// 更多日期的数据...
]
}
]
}
未复权数据响应
{
"code": 200,
"message": "success",
"data": {
"symbol": "600519",
"name": "贵州茅台",
"daily": [
{
"date": "2023-01-31",
"open": 1726.40,
"high": 1746.00,
"low": 1720.00,
"close": 1740.00,
"pre_close": 1725.00,
"change": 15.00,
"pct_change": 0.87,
"volume": 2231600,
"amount": 3868984200.00,
"turnover": 0.18,
"adj_factor": 1.00
},
// 更多日期的数据...
]
}
}
错误码
除了通用错误码外,此接口还可能返回以下错误码:
| 错误码 | 描述 |
|---|
invalid_symbol | 无效的股票或指数代码 |
invalid_date_format | 日期格式错误 |
date_range_too_large | 日期范围过大,超过允许的最大范围(3年) |
too_many_symbols | 请求的股票代码数量超过上限(最多支持50个) |
no_data | 指定日期范围内无数据 |
注意事项
- 若查询日期范围内有停牌的交易日,对应日期的数据不会返回。
- 默认返回的是前复权数据,适合用于计算涨跌幅等技术分析。
- 当
adjusted=false时,返回未复权数据和复权因子,可用于手动计算后复权数据。
- 日线数据按照交易日期降序排列,即最新日期在最前面。
- 单次请求的日期范围最大不超过3年,若需更多数据,请分多次请求。
- 成交量的单位为”手”(1手 = 100股),成交金额的单位为”元”。
复权说明
- 前复权:将历史数据按最新复权因子调整,使得历史价格能够反映真实涨跌情况。适合用于计算涨跌幅、画K线图等。
- 不复权:返回历史上的实际交易价格和复权因子。可以结合复权因子自行计算任意时点为基准的复权价格。
复权公式
假设某只股票在时间t的未复权价格为P(t),复权因子为AF(t),则:
- 前复权价格 = P(t) × [AF(t) / AF(now)]
- 后复权价格 = P(t) × AF(t)
其中,AF(now)为最新交易日的复权因子。
相关接口