market-ohlcv

Market OHLCV 统一行情接口 Skill

定位

本 Skill 只描述数据接口、调用方式、输出字段和边界，不承载真实抓取/解析逻辑。真实实现位于：

data_sources.market_ohlcv

技术分析 Skill 或 Agent 需要行情数据时，应直接调用 data_sources.market_ohlcv，不要在 skills/technical/ 内实现数据源细节，也不要再通过 skills/data/market_ohlcv/scripts/ohlcv_loader.py 中转；该旧包装入口已移除。

当前运行时边界：

• data_sources/：真实 HTTP 请求、CSV 解析、字段归一化、数据源兜底策略。
• skills/data/market_ohlcv/SKILL.md：接口契约说明，供 Agent/Skill 作者理解如何调用。
• skills/technical/：只做技术分析，不持有行情数据源实现。

推荐调用方式

直接函数调用

from data_sources.market_ohlcv import load_rows_from_code, load_ohlcv_csv

rows, uncertainties = load_rows_from_code(
    code="600519",
    start="2026-01-01",
    end="2026-05-23",
    freq="D",
    adjust="none",
)

类封装调用

from data_sources.market_ohlcv import MarketOhlcvDataSource

source = MarketOhlcvDataSource()
rows, uncertainties = source.load_rows_from_code("600519", "2026-01-01", "2026-05-23")

CSV 调用

from data_sources.market_ohlcv import load_ohlcv_csv

rows = load_ohlcv_csv("/path/to/ohlcv.csv")

接口

load_rows_from_code(code, start, end, freq="D", adjust="none")

统一股票代码行情入口。优先 EastMoney，失败或未配置 EASTMONEY_UT 时兜底到 Tencent Technical。

参数：

参数	类型	必填	说明
code	str	是	股票代码，如 600519、000001、300750
start	str	是	开始日期，格式 YYYY-MM-DD
end	str	是	结束日期，格式 YYYY-MM-DD
freq	str	否	K 线周期：D/W/M，默认 D
adjust	str	否	复权口径，默认 none；Tencent 兜底对复权口径存在近似说明

返回：

Tuple[List[Dict], List[str]]

• 第一个元素 rows：标准化 OHLCV 行情数组。
• 第二个元素 uncertainties：数据源选择、复权口径、异常兜底等不确定性说明。

每条 row 至少包含：

{
  "date": "2026-05-22",
  "open": 1300.0,
  "high": 1310.0,
  "low": 1280.0,
  "close": 1290.2,
  "volume": 49157.0
}

可选字段：amount、turnover_rate、turnover、money。

uncertainties 示例：

[
    "未配置 EASTMONEY_UT，使用 data_sources.tencent_technical 行情数据源。",
    "Tencent 行情接口默认返回 qfq/前复权日线，可能与 EastMoney none 口径存在差异。",
    "行情来源：tencent_technical:sh600519",
]