更新日志

本页面记录 zer0data SDK 的主要更新内容。

---

v0.1.0 - 2026-03-03

🚀 首次发布

zer0data SDK 正式发布，提供币安永续合约 K 线数据与合约元数据的 Python 查询接口。

✨ 功能

K 线数据查询

• get_kline()：查询 K 线（OHLCV）数据，底层通过 DolphinDB KlineMasterRepo 执行
• 支持单标的或多标的列表批量查询
• 支持 8 种周期：1m / 5m / 15m / 30m / 1h / 2h / 4h / 1d
• 支持字段过滤（fields 参数）
• 支持分页（limit + offset）
• 支持复权类型：none / pre / post

合约元数据查询

• get_symbols()：从本地 exchangeInfo.json 快照读取合约元数据
• 支持三个市场：spot（现货）/ um（U 本位永续）/ cm（币本位永续）
• 支持按计价资产（quote_asset）过滤
• 支持一键排除稳定币底层资产（exclude_stable_base）
• 返回固定 6 列：symbol / quoteAsset / onboardDate / deliveryDate / underlyingType / status

统一入口

• Client 类作为统一入口，组合 KlineService 和 SymbolService 两个子服务
• 支持通过 client.get_kline() / client.get_symbols() 快捷调用
• 支持通过 client.kline / client.symbols 直接访问子服务

🔧 依赖

包	版本要求
Python	>=3.11
pandas	>=2.0
dbmodule	>=0.1.0

---

开始使用： 快速开始 →