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

# Data frequency

# 数据频率

在使用AlphaFinance API获取时间序列数据（如股票价格和交易量）时，您可以选择不同的数据频率来满足您的需求。本文档详细介绍了支持的数据频率以及如何在API请求中指定它们。

## 支持的数据频率

AlphaFinance API支持以下数据频率：

| 频率代码             | 描述   | 典型用途          |
| ---------------- | ---- | ------------- |
| `1m`             | 1分钟  | 短期交易策略、高频交易分析 |
| `5m`             | 5分钟  | 日内交易模式分析      |
| `15m`            | 15分钟 | 日内趋势分析        |
| `30m`            | 30分钟 | 中短期趋势识别       |
| `60m`/`1h`       | 1小时  | 日间交易模式分析      |
| `daily`/`1d`     | 日线   | 基础技术分析、中期趋势   |
| `weekly`/`1w`    | 周线   | 中长期趋势分析       |
| `monthly`/`1M`   | 月线   | 长期趋势和战略分析     |
| `quarterly`/`1q` | 季度线  | 长期投资决策        |
| `yearly`/`1y`    | 年线   | 长期战略分析        |

## 默认频率

如果未在请求中指定频率，大多数API端点将默认使用日线（`daily`）数据。

## 使用数据频率参数

在API请求中，您可以使用`interval`或`frequency`参数（根据不同端点）来指定所需的数据频率：

```bash theme={null}
curl -X GET "https://api.alphafin.x-pai.com/v1/market/klines?symbol=600519&interval=15m&begin_date=2023-05-10&end_date=2023-05-10" \
  -H "X-API-KEY: your_api_key_here"
```

## 不同频率的数据可用性

请注意，不同频率的数据在可用性上存在差异：

* **分钟级数据**（1m, 5m, 15m, 30m, 60m）：
  * 通常提供最近1-3个月的历史数据
  * 交易时段内实时更新
  * 不包含盘前盘后交易

* **日线及以上频率数据**（daily, weekly, monthly等）：
  * 提供完整的历史数据，从股票上市日开始
  * 日线数据在每个交易日收盘后更新
  * 周线、月线等在相应周期结束后更新

<Warning>
  分钟级数据的存储周期有限。如果您需要长期存储分钟级历史数据，建议定期获取并自行存储。
</Warning>

## 交易时段外数据

A股市场的正常交易时段为：

* 上午：9:30 - 11:30
* 下午：13:00 - 15:00

在非交易时段（如夜间、周末和节假日）获取实时数据时，API将返回最近的可用数据，并在响应中标明数据的时间戳。

## 调整与未调整数据

对于历史价格数据，您可以选择获取经过调整的数据（考虑除权除息）或原始未调整数据：

```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-04-30&adjusted=true" \
  -H "X-API-KEY: your_api_key_here"
```

参数说明：

* `adjusted=true`：返回经过除权除息调整的价格数据（默认）
* `adjusted=false`：返回原始未调整的价格数据

## 频率转换

如果您需要的特定频率不直接可用，可以考虑以下方法：

1. **下采样**：获取更高频率的数据，然后自行聚合
   * 例如，要获取2小时数据，可以获取1小时数据然后每两条聚合

2. **上采样**：获取较低频率的数据，然后进行插值
   * 例如，基于日线数据估算不提供的特定时间点价格

<Note>
  我们建议尽可能使用API直接提供的频率，而不是自行转换，以确保数据准确性。
</Note>

## 数据延迟

不同订阅计划的数据可能存在不同的延迟：

| 计划  | 日线及以上数据延迟 | 分钟级数据延迟 |
| --- | --------- | ------- |
| 入门版 | 15分钟      | 15分钟    |
| 专业版 | 实时        | 1分钟     |
| 企业版 | 实时        | 实时      |

## 常见问题

<AccordionGroup>
  <Accordion title="为什么我无法获取到特定日期的分钟级数据？">
    可能的原因包括：

    1. 该日为非交易日（周末或节假日）
    2. 数据已超出存储期限（通常为1-3个月）
    3. 该时段市场暂停交易

    建议查询 [交易日历API](/api-reference/market/trading-calendar) 确认是否为交易日。
  </Accordion>

  <Accordion title="如何处理除权除息事件？">
    默认情况下，我们的API会返回前复权后的价格数据。您可以通过设置 `adjusted=false` 获取未调整的原始价格，或使用 [除权除息API](/api-reference/events/dividends) 获取详细的除权除息信息。
  </Accordion>

  <Accordion title="分钟级数据是否包含盘前盘后时段？">
    不包含。我们的分钟级数据仅覆盖A股正常交易时段（9:30-11:30, 13:00-15:00）。
  </Accordion>
</AccordionGroup>

## 使用示例

### 获取日K数据

```python theme={null}
import requests

api_key = "your_api_key_here"
url = "https://api.alphafin.x-pai.com/v1/market/klines"

params = {
    "symbol": "600519",
    "interval": "daily",
    "begin_date": "2023-01-01",
    "end_date": "2023-01-31"
}

headers = {
    "X-API-KEY": api_key
}

response = requests.get(url, params=params, headers=headers)
data = response.json()

print(data)
```

### 获取15分钟K线数据

```python theme={null}
import requests

api_key = "your_api_key_here"
url = "https://api.alphafin.x-pai.com/v1/market/klines"

params = {
    "symbol": "600519",
    "interval": "15m",
    "begin_date": "2023-05-10",
    "end_date": "2023-05-10"
}

headers = {
    "X-API-KEY": api_key
}

response = requests.get(url, params=params, headers=headers)
data = response.json()

print(data)
```

## 相关资源

* [行情数据API](/api-reference/market/daily)
* [K线数据API](/api-reference/market/klines)
* [交易日历API](/api-reference/market/trading-calendar)
* [除权除息API](/api-reference/events/dividends)