> ## 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.

# Daily

# 日线行情数据

获取A股市场股票和指数的日线行情数据，包括开盘价、收盘价、最高价、最低价、成交量等信息。

## 接口说明

### HTTP请求

```
GET /v1/market/daily
```

### 请求参数

| 参数名          | 类型  | 必选 | 描述                                                                          |
| ------------ | --- | -- | --------------------------------------------------------------------------- |
| `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`时返回 |

## 示例

### 请求示例

#### 获取单个股票的日线数据

```bash theme={null}
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"
```

#### 获取多个股票的日线数据

```bash theme={null}
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"
```

#### 获取未复权数据

```bash theme={null}
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"
```

#### 获取指定字段

```bash theme={null}
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"
```

### 响应示例

#### 单个股票响应

```json theme={null}
{
  "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
      },
      // 更多日期的数据...
    ]
  }
}
```

#### 多个股票响应

```json theme={null}
{
  "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
        },
        // 更多日期的数据...
      ]
    }
  ]
}
```

#### 未复权数据响应

```json theme={null}
{
  "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`              | 指定日期范围内无数据             |

## 注意事项

1. 若查询日期范围内有停牌的交易日，对应日期的数据不会返回。
2. 默认返回的是前复权数据，适合用于计算涨跌幅等技术分析。
3. 当`adjusted=false`时，返回未复权数据和复权因子，可用于手动计算后复权数据。
4. 日线数据按照交易日期降序排列，即最新日期在最前面。
5. 单次请求的日期范围最大不超过3年，若需更多数据，请分多次请求。
6. 成交量的单位为"手"（1手 = 100股），成交金额的单位为"元"。

## 复权说明

1. **前复权**：将历史数据按最新复权因子调整，使得历史价格能够反映真实涨跌情况。适合用于计算涨跌幅、画K线图等。
2. **不复权**：返回历史上的实际交易价格和复权因子。可以结合复权因子自行计算任意时点为基准的复权价格。

### 复权公式

假设某只股票在时间t的未复权价格为P(t)，复权因子为AF(t)，则：

* 前复权价格 = P(t) × \[AF(t) / AF(now)]
* 后复权价格 = P(t) × AF(t)

其中，AF(now)为最新交易日的复权因子。

## 相关接口

* [分钟线数据](/api-reference/market/intraday)
* [K线数据](/api-reference/market/klines)
* [复权因子](/api-reference/market/adjustment-factor)
* [交易日历](/api-reference/market/trading-calendar)