DataFeed on 菠萝学

数据源 DataFeed 详解

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

Backtrader 提供了一组数据源解析器（目前都是基于 CSV 的），用于从不同来源加载数据。

Yahoo（在线或已保存到文件）
VisualChart（参见 www.visualchart.com）
Backtrader CSV（自定义格式用于测试）
通用 CSV 支持

如快速入门指南所示，将数据源添加到 Cerebro 实例后，可在策略中通过以下方式访问：

自定义扩展数据源

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

能否轻松扩展现有机制，添加额外字段并与价格数据（如开盘价、最高价等）一起传递？

正在解析一个 CSV 格式的数据源
使用 GenericCSVData 加载数据
通用 CSV 支持是为响应 Issue #6 开发的
需要将 P/E 字段与解析的 CSV 数据一起传递

下面基于 CSV 数据源开发和 GenericCSVData 示例来演示。

开发 CSV 格式数据源

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

Backtrader 已经提供了一些通用和特定的 CSV 数据源。

GenericCSVData
VisualChartCSVData
YahooFinanceData（用于在线下载）
YahooFinanceCSVData（用于已下载的数据）
BacktraderCSVData（内部用于测试，但也可以使用）

即使如此，你可能仍需要开发对特定 CSV 数据源的支持。

开发 Binary 二进制数据源

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

注意：示例中使用的 Binary 文件 goog.fd 属于 VisualChart，不能与 backtrader 一起分发。

对于那些有兴趣直接使用 Binary 文件的人，可以免费下载 VisualChart。

CSV 数据源开发展示了如何添加基于 CSV 的数据源。基类 CSVDataBase 提供了框架，子类只需执行：

多时间框架数据源

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

实际交易中常需要结合多个时间框架来制定决策，如在周线评估趋势、在日线执行入场，或基于 5 分钟与 60 分钟数据的对比进行交易。在 Backtrader 中需要将不同时间框架的数据组合在一起。

数据重采样与周期转换

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

当只有单一时间框架的数据可用，而分析需要在不同时间框架上进行时，就需要重采样。“重采样” 实际应称为 “上采样”，因为它是从源时间框架转换到更大的时间框架（如从天到周）。

Tick 级数据回放机制

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

仅对已完成的 Bar 进行策略测试已不够，数据回放应运而生。假设策略在时间框架 X（如每日）上操作，而数据在更小的时间框架 Y（如 1 分钟）上可用。

数据回放正如其名，使用 1 分钟数据来重建每日 Bar。虽然不能完全再现市场发展，但比观察已完成的每日 Bar 要好得多。这可以近似模拟策略在每日 Bar 形成过程中的实际表现。

数据滚动与窗口管理

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

并非所有提供商都提供连续期货合约数据。有时提供的是仍在交易中的到期合约数据，这使得回测很不方便，因为数据分散在多个合约上，且合约在时间上重叠。

数据过滤器 Filter 详解

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

该功能是较晚加入到 Backtrader 中的，为适应已有的内部结构做了一些调整。因此它在灵活性和功能完备性上可能不如预期，但在许多情况下仍然够用。

尽管实现时尝试支持即插即用的过滤器链，但受限于原有内部结构，无法始终保证。因此，有些过滤器可以链式使用，有些则不能。

过滤器参数参考文档

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

SessionFilter
#

class backtrader.filters.SessionFilter(data)

过滤掉常规交易时间外的日内数据（即盘前/盘后数据）。

这是一个”非简单”过滤器，必须管理数据栈。
不需要 “last” 方法，因为没有需要推送的数据。

SessionFilterSimple
#

class backtrader.filters.SessionFilterSimple(data)

Yahoo 数据源接入说明

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

2017 年 5 月，Yahoo 停用了原有的 CSV 格式历史数据下载 API。随后新的 API（这里称为 v7）被标准化并已实现，也带来了 CSV 下载格式的变化。

使用 v7 API/格式
#

从 1.9.49.116 版本开始，这是默认行为。直接使用：

Pandas 数据源使用示例

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

注意，需要安装 pandas 及其依赖项。支持 Pandas Dataframe 很重要，许多人依赖 Pandas 提供的解析功能来处理不同数据源（包括 CSV）。

参数声明
#

注意

数据源 API 参考文档

poloxue123@gmail.com (POLO XUE) — Wed, 20 May 2026 00:00:00 +0000

AbstractDataBase
#

数据行（Lines）:

close
low
high
open
volume
openinterest
datetime

参数（Params）:

dataname (None)
name ()
compression (1)
timeframe (5)
fromdate (None)
todate (None)
sessionstart (None)
sessionend (None)
filters ([])
tz (None)
tzinput (None)
qcheck (0.0)
calendar (None)

BacktraderCSVData
#

解析用于测试的自定义 CSV 数据。

DataFeed on 菠萝学

数据源 DataFeed 详解

自定义扩展数据源

开发 CSV 格式数据源

开发 Binary 二进制数据源

多时间框架数据源

数据重采样与周期转换

Tick 级数据回放机制

数据滚动与窗口管理

数据过滤器 Filter 详解

过滤器参数参考文档

SessionFilter #

SessionFilterSimple #

Yahoo 数据源接入说明

使用 v7 API/格式 #

Pandas 数据源使用示例

参数声明 #

数据源 API 参考文档

AbstractDataBase #

BacktraderCSVData #

SessionFilter
#

SessionFilterSimple
#

使用 v7 API/格式
#

参数声明
#

AbstractDataBase
#

BacktraderCSVData
#