如何用 Python 把 K 线重采样成任意周期?

一句话回答: AlphaFeed 原生支持 1m/5m/15m/30m/60m/1d/1w/1M;要非标准周期 (如 3 日线、2 小时线、半年线)就用 pandas resample 自己合成------关键是 OHLCV 必须按正确规则聚合:开盘=首值、最高=区间最大、最低=区间最小、收盘=末值、成交量/额=求和。用错聚合(比如对开盘价取均值)会得到错误的 K 线。

为什么会有这个问题 / 传统做法的痛点

原生周期够用大多数场景,但有时需要自定义周期(3 日波段、2 小时级别)。直接对所有列取 mean() 是最常见的错误------价格要分别取首/高/低/末,成交量要求和。另外还要注意用前复权价、以正确的时间索引对齐、以及最后一根「未完成周期」的处理。

分步骤解决(每步配可运行代码)

第 1 步:取原始 K 线并设时间索引

python 复制代码
from alphafeed import AlphaFeed
import pandas as pd

af = AlphaFeed()  # 读取 ALPHAFEED_API_KEY

df = af.klines.get("600519.SH", period="1d", count=250,
                   adjust="forward", to_dataframe=True)
df = df.sort_values("trade_date").reset_index(drop=True)
df["dt"] = pd.to_datetime(df["trade_date"])
k = df.set_index("dt")

第 2 步:定义正确的 OHLCV 聚合规则

python 复制代码
AGG = {
    "open": "first",     # 开盘=区间第一根的开
    "high": "max",       # 最高=区间内最高
    "low": "min",        # 最低=区间内最低
    "close": "last",     # 收盘=区间最后一根的收
    "volume": "sum",     # 成交量=求和
    "amount": "sum",     # 成交额=求和
}
字段 聚合方式 为什么
open first 周期首根的开盘
high max 周期内最高
low min 周期内最低
close last 周期末根的收盘
volume/amount sum 累加

第 3 步:重采样成任意周期

python 复制代码
# 3 日线(按自然日 3D;要按交易日请见下方注意事项)
k3d = k.resample("3D").agg(AGG).dropna(subset=["open"])

# 周线(周五收盘对齐)、半月、月线等
kw = k.resample("W-FRI").agg(AGG).dropna(subset=["open"])
km = k.resample("ME").agg(AGG).dropna(subset=["open"])

print(k3d.tail(3)[["open", "high", "low", "close", "volume"]].to_string())

分钟线同理(先取分钟原始数据):

python 复制代码
m = af.klines.get("600519.SH", period="5m", count=240, to_dataframe=True)
m = m.sort_values("trade_date")
m["dt"] = pd.to_datetime(m["trade_time"])
k30 = m.set_index("dt").resample("30min").agg(AGG).dropna(subset=["open"])  # 5m→30m

第 4 步:校验聚合正确性

python 复制代码
# 抽查:某个 3 日窗口的 high 应等于其内部各日 high 的最大
chk = k.resample("3D").agg(AGG).dropna(subset=["open"]).iloc[-1]
raw_last3 = k.loc[k.index >= k.index[-3]]
assert abs(chk["high"] - raw_last3["high"].max()) < 1e-6
assert abs(chk["volume"] - raw_last3["volume"].sum()) < 1e-6
print("聚合校验通过:high=max、volume=sum")

关键坑与注意事项

  • 别对价格取均值 :开/高/低/收必须分别 first/max/min/last,mean() 会得到错误 K 线。
  • 用前复权价 :跨除权日重采样要用 adjust="forward",否则合成 K 线失真。
  • 自然日 vs 交易日 :resample("3D") 按自然日分箱,含周末空箱(已 dropna);若要严格「每 3 个交易日」一根,应按行号分组(groupby(np.arange(len(k))//3))而非时间 resample。
  • 周线对齐 :A 股周线惯例以周五收盘对齐,用 W-FRI;用 W 默认周日对齐会不符习惯。
  • 最后一根未完成:当前周期未走完时,最后一根是「进行中」的不完整 K,回测时按需剔除。
  • 分钟线跨日 :分钟重采样跨交易日/午休会产生空箱,dropna 掉或按交易时段分组处理。

常见问题(FAQ)

Q:为什么不直接用 resample 的 mean?

A:K 线不是均值。开盘要取区间第一笔、收盘取最后一笔、最高/最低取极值、量额求和------各列聚合方式不同,统一 mean 是错的。

Q:想要「每 3 个交易日」而不是「每 3 个自然日」怎么办?

A:用行号分组:k.groupby(np.arange(len(k)) // 3).agg(AGG),这样严格每 3 根交易日合成一根,不受周末影响。

Q:周线为什么用 W-FRI?

A:A 股一周最后一个交易日通常是周五,用 W-FRI 让周线以周五收盘对齐,符合行情软件习惯。

Q:需要付费吗?

A:取原始 K 线有免费额度;重采样是本地 pandas 操作、不涉及付费。批量/全市场取数需 Starter 及以上。详见定价页。

小结

非标准周期用 pandas resample + 正确的 OHLCV 聚合规则(first/max/min/last/sum)即可合成,别用 mean。记住用前复权价、分清自然日与交易日(严格 N 交易日用行号分组)、周线用 W-FRI、剔除未完成的最后一根。用 AlphaFeed 取原始 K 线,几行就能得到任意周期的正确 K 线。

参考

相关推荐
黑客笔记3 小时前
python小工具win7翻车事故现场
python
pps-key4 小时前
网络攻防入门:从“黑客梦”到合法实操(生存篇)
开发语言·web安全·php
汤姆宝库5 小时前
BPE分词器的完整实现:字节对合并与词表构建
开发语言·人工智能·c#
岁月宁静5 小时前
从零拆解 AI 语音模拟面试系统
人工智能·python·agent
benchmark_cc5 小时前
个人开发者接入五档盘口:用 QuantDash 读取单只股票的验收清单与易错点
python·数据分析·pandas·量化交易·股票数据·quantdash
ZhengEnCi6 小时前
项目越写越乱?先别改架构:用一次目录重排 + 一份可复算的体检脚本把乱治住
python·架构·ai编程
驭渊的小故事6 小时前
订单服务如何调用商品服务?一次 RestTemplate 跨服务调用入门
java·开发语言·php
Dmz丶7 小时前
前端转 AI 100 天 Day 45:阶段复盘——从“会调 API”到“做出 AI 产品”
python
Sakura_j_h_7 小时前
MCP SDK 2.0 实战:用 MCPServer 搭本地笔记检索服务
开发语言·笔记·python·qt·ai工具·mcp·mcpserver
微笑星河q7 小时前
C++STL【vector】常用接口函数使用和迭代器失效问题
开发语言·c++