Skip to main content

​
数据频率

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

​
支持的数据频率

AlphaFinance API支持以下数据频率：
频率代码描述典型用途
1m1分钟短期交易策略、高频交易分析
5m5分钟日内交易模式分析
15m15分钟日内趋势分析
30m30分钟中短期趋势识别
60m/1h1小时日间交易模式分析
daily/1d日线基础技术分析、中期趋势
weekly/1w周线中长期趋势分析
monthly/1M月线长期趋势和战略分析
quarterly/1q季度线长期投资决策
yearly/1y年线长期战略分析

​
默认频率

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

​
使用数据频率参数

在API请求中，您可以使用interval或frequency参数（根据不同端点）来指定所需的数据频率： 
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等）：
    • 提供完整的历史数据，从股票上市日开始
    • 日线数据在每个交易日收盘后更新
    • 周线、月线等在相应周期结束后更新
分钟级数据的存储周期有限。如果您需要长期存储分钟级历史数据，建议定期获取并自行存储。

​
交易时段外数据

A股市场的正常交易时段为：
  • 上午：9:30 - 11:30
  • 下午：13:00 - 15:00
在非交易时段（如夜间、周末和节假日）获取实时数据时，API将返回最近的可用数据，并在响应中标明数据的时间戳。

​
调整与未调整数据

对于历史价格数据，您可以选择获取经过调整的数据（考虑除权除息）或原始未调整数据： 
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. 上采样：获取较低频率的数据，然后进行插值
    • 例如，基于日线数据估算不提供的特定时间点价格
我们建议尽可能使用API直接提供的频率，而不是自行转换，以确保数据准确性。

​
数据延迟

不同订阅计划的数据可能存在不同的延迟：
计划日线及以上数据延迟分钟级数据延迟
入门版15分钟15分钟
专业版实时1分钟
企业版实时实时

​
常见问题

可能的原因包括：
  1. 该日为非交易日（周末或节假日）
  2. 数据已超出存储期限（通常为1-3个月）
  3. 该时段市场暂停交易
建议查询 交易日历API 确认是否为交易日。
默认情况下，我们的API会返回前复权后的价格数据。您可以通过设置 adjusted=false 获取未调整的原始价格，或使用 除权除息API 获取详细的除权除息信息。
不包含。我们的分钟级数据仅覆盖A股正常交易时段（9:30-11:30, 13:00-15:00）。

​
使用示例

​
获取日K数据

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线数据

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)

​
相关资源