数据源
接入专业行情数据服务商，覆盖中国市场的 A 股、ETF 与指数，统一采集、校验与入库。
Bastix 接入专业行情数据服务商作为行情数据源，覆盖中国市场的 A 股、ETF 与指数。数据经统一的采集、校验与入库流程落地，并以标准化的查询接口对外服务。数据接入层做了来源抽象，可在不改动上层使用方式的前提下扩展数据覆盖。
覆盖范围
| 标的类型 | 说明 |
|---|---|
CN_A | 中国 A 股：K 线、快照、画像、财报 |
CN_ETF | 中国 ETF：K 线、基础信息、持仓成分 |
CN_INDEX | 中国指数：K 线、基础信息、指数成分 |
数据品类
1. K 线数据（OHLCV）
支持 1分钟、60分钟、日线 三种周期，覆盖 A 股、ETF 和指数。
字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
eventTime | DateTime | K 线时间戳（UTC ISO 格式） |
open | Float | 开盘价 |
high | Float | 最高价 |
low | Float | 最低价 |
close | Float | 收盘价 |
volume | Float | 成交量（可选） |
amount | Float | 成交额（可选） |
turnover | Float | 换手率（可选） |
系列元数据：每个 K 线序列包含 symbol（标的代码）、venue（交易所）、timeframe（周期）、instrumentType（标的类型）等标识信息。
2. 最新快照
某标的最新价格、成交量与新鲜度状态（fresh / stale / unknown），用于实时监控和快速查询最新行情。
3. 标的信息（个股资料）
静态资料与动态状态，覆盖 A 股。以下为高优先级字段：
核心字段
| 字段 | 说明 |
|---|---|
symbol | 标的代码（如 600519.SH） |
stockCode | 股票代码（如 600519） |
stockName | 股票简称 |
companyName | 公司全称 |
instrumentType | 标的类型（CN_A / CN_ETF / CN_INDEX） |
venue | 交易所 |
asOfDate | 数据快照日期 |
上市信息
| 字段 | 说明 |
|---|---|
listingExchange | 上市交易所 |
listedSector | 上市板块（主板 / 创业板 / 科创板等） |
listedStatus | 上市状态（上市 / 终止上市 / 暂停上市） |
tradingStatus | 交易状态（正常 / 停牌） |
continuousSuspensionDays | 连续停牌天数 |
suspensionReason | 停牌原因 |
行业与概念
| 字段 | 说明 |
|---|---|
thsIndustry | 所属同花顺行业 |
concept | 所属概念（可含多个） |
公司基本信息
| 字段 | 说明 |
|---|---|
legalRepresentative | 法人代表 |
province | 省份 |
mainBusiness | 主营业务 |
operatingScope | 经营范围 |
股权结构
| 字段 | 说明 |
|---|---|
controllingHolder | 控股股东 |
actualController | 实际控制人 |
市场特征
| 字段 | 说明 |
|---|---|
isMtSsUnderlying | 是否融资融券标的 |
isImportantIndexConstituent | 是否属于重要指数成分 |
标的信息实际支持 100+ 个字段，包括跨市场关联（B 股 / H 股 / 美股代码）、法律顾问、审计机构、详细行业分类等。上述为常用的核心字段。
4. 公告数据
覆盖 A 股，按报告日期与标题检索。
字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
seq | String | 唯一标识 |
reportDate | Date | 公告日期 |
title | String | 公告标题 |
category | String | 公告分类（可选，中文标签） |
hasDocument | Boolean | 是否有 PDF 文档可供查阅 |
公告分类
公告按类型分为以下几类（具体分类由数据源 reportType 字段决定）：
- 定期报告：年度报告、半年度报告、季度报告
- 业绩预告：业绩预告、业绩快报、业绩修正
- 股权变动：股东增减持、股权质押 / 解质押、股份回购
- 重大事项：资产重组、收购兼并、对外投资、关联交易
- 分配方案：利润分配、资本公积转增、配股 / 增发
- 风险警示：ST / 退市风险、异常波动、澄清公告
- 一般公告：其他公告
PDF 文档通过平台代理服务访问，使用 seq 作为标识。
5. 财务数据
单标的最新一期财务指标，覆盖 A 股（ETF 和指数无财务数据）。
完整字段列表
| 字段 | 说明 | 指标类型 |
|---|---|---|
symbol | 标的代码 | - |
报告期 | 报告期（如 2024-12-31） | 元信息 |
数据可见日 | 数据实际可用时点（PIT 口径） | 元信息 |
营业收入 | 营业总收入（元） | 利润表 |
归母净利润 | 归属母公司股东净利润（元） | 利润表 |
净资产收益率 | ROE（%） | 盈利能力 |
销售毛利率 | 毛利率（%） | 盈利能力 |
销售净利率 | 净利率（%） | 盈利能力 |
营收同比 | 营业收入同比增长率（%） | 成长性 |
净利润同比 | 净利润同比增长率（%） | 成长性 |
资产负债率 | 资产负债率（%） | 偿债能力 |
经营现金流 | 经营活动现金流净额（元） | 现金流量表 |
每股收益 | 基本每股收益（元 / 股） | 每股指标 |
数据口径说明
- 报告期 vs 数据可见日：
报告期是财务数据所属的会计期间，数据可见日是数据实际披露可用的日期，避免回测中使用未来数据。 - PIT（Point-in-Time）口径：
营业收入、归母净利润、每股收益使用可回测版本，防止未来函数。 - 最终修正值口径：
净资产收益率、销售毛利率使用最终修正版（数据源暂无 PIT 版本）。
6. 龙虎榜数据
日维度的原因、类型、净买额、买入 / 卖出额，覆盖 A 股。
字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
tradeDate | Date | 交易日期 |
symbol | String | 标的代码 |
stockCode | String | 股票代码 |
stockName | String | 股票简称（可选） |
lhbReason | String | 上榜原因（如"日涨幅偏离值达 7%"） |
lhbType | String | 龙虎榜类型（可选） |
lhbNetAmount | Float | 净买入额（元） |
lhbBuyAmount | Float | 买入总额（元） |
lhbSellAmount | Float | 卖出总额（元） |
7. 交易日历
交易所某日是否交易，用于日期范围查询与回测。
字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
exchange | String | 交易所代码 |
tradeDate | Date | 日期 |
isTradingDay | Boolean | 是否为交易日 |
8. 成分数据
ETF 持仓与指数成分，统一为通用成分 / 权重 / 快照模型。
ETF 持仓
| 字段 | 说明 |
|---|---|
etfSymbol | ETF 代码 |
snapshotDate | 快照日期 |
componentSymbol | 成分股代码 |
componentName | 成分股名称（可选） |
weightPct | 权重占比（%） |
shares | 持股数量（可选） |
marketValue | 持股市值（可选） |
指数成分
| 字段 | 说明 |
|---|---|
indexSymbol | 指数代码 |
indexName | 指数名称 |
memberSymbol | 成分股代码 |
effectiveDate | 生效日期 |
weightPct | 权重占比（%） |
数据是怎么进来的
行情数据按品类定时采集、统一校验后入库，并按交易日历与 K 线收盘节奏持续更新：
- 交易日历同步、A 股 / ETF / 指数基础信息更新
- A 股 / ETF / 指数 日线与分钟线
- 公告、龙虎榜日数据
- 指数成分、ETF 持仓同步
采集过程做了幂等与重试，每批数据都带完整性记录，保证更新可靠、缺口可被发现并补齐。
数据质量与时间口径
- 所有内部事件时间统一使用 UTC ISO 字符串；中国市场本地时区固定为
Asia/Shanghai。 - 财报等定期披露数据同时标注报告期与数据可见日（数据实际可用的时点），避免用未来才披露的数字回看历史。
- 读取结果附带元信息：数据新鲜度（
asOf）与一致性指纹，便于判断数据是否最新、可信。