数据服务
ETF/LOF 持仓
提供 ETF/LOF 持仓明细、PCF 申赎清单、净值、IOPV、折溢价与规模数据,支持按基金与日期查询。
持仓明细PCF 清单净值 / IOPV折溢价
ETF 与 LOF 同时存在一级申赎与二级交易,持仓与申赎清单是连接两个市场的关键。持仓明细用于穿透底层资产,PCF 清单用于申购赎回,净值与 IOPV 则用于折溢价观察。
FTLib 提供基金持仓、PCF、净值、IOPV、折溢价与规模数据。研究者可以穿透 ETF 的行业与个股暴露,也可以研究折溢价、申赎套利与基金份额变化。
覆盖范围
持仓明细来自定期报告,存在披露滞后;PCF 清单通常按日更新。两者用途不同,不能互相替代。
| 项目 | 说明 |
|---|---|
| 覆盖品种 | ETF、LOF |
| 持仓 | 前十大持仓与定期报告披露的完整持仓 |
| PCF | 申购赎回清单、现金替代标志、最小申赎单位 |
| 净值 | 单位净值、累计净值 |
| IOPV | 盘中参考净值(如披露) |
| 折溢价 | 二级价格相对净值或 IOPV 的偏离 |
| 规模 | 基金份额、资产净值 |
| 接入方式 | REST |
字段说明
持仓权重为百分数,市值单位为元。PCF 记录按基金与交易日组织,现金替代标志保留原始定义。
| 字段 | 类型 | 说明 |
|---|---|---|
fund_code | string | 基金代码 |
fund_name | string | 基金名称 |
date | string | 数据日期 |
nav | number | 单位净值 |
iopv | number | 盘中参考净值 |
premium_rate | number | 折溢价率,百分比 |
holding_symbol | string | 持仓证券代码 |
holding_name | string | 持仓证券名称 |
weight | number | 持仓权重,百分比 |
shares | int64 | 持仓数量 |
market_value | number | 持仓市值,元 |
pcf_flag | string | 现金替代标志 |
请求示例
以下请求获取某 ETF 在指定日期的持仓与净值。PCF 使用 /v1/funds/pcf 查询。
持仓与净值查询
date 省略时返回最新可用数据;持仓完整度取决于基金披露频率。
bash
curl -H "Authorization: Bearer $FTLIB_API_KEY" \
"https://api.ftlib.com/v1/funds/holdings?fund=510300.SH&date=2026-11-13"
返回结构
示例数据仅用于说明字段,不代表真实基金持仓。
json
{
"code": 0,
"message": "ok",
"request_id": "req_a17b3e58",
"data": {
"fund_code": "510300.SH",
"fund_name": "示例沪深300ETF",
"date": "2026-11-13",
"nav": 4.1286,
"iopv": 4.1312,
"premium_rate": 0.06,
"holdings": [
{
"holding_symbol": "600519.SH",
"holding_name": "贵州茅台",
"weight": 4.12,
"shares": 1260000,
"market_value": 2126880000.00
}
]
}
}
数据口径与更新
- 定期报告持仓存在披露滞后,通常按季度或半年度披露。用最新持仓回测历史会引入前视偏差。
- PCF 清单按日更新,包含成分证券、数量、现金替代与最小申赎单位,是申赎套利计算的核心输入。
- IOPV 是盘中参考净值,由数据供应商估算,可能与最终净值存在差异;折溢价计算应明确使用 NAV 还是 IOPV。
- 基金可能进行份额拆分、分红与折算,净值和价格序列需要同步调整,否则折溢价会出现虚假跳变。
- LOF 的申赎与交易机制与 ETF 不同,PCF 字段可用性也可能不同,使用前应确认基金类型。
持仓披露滞后
ETF 持仓明细不是实时数据。若研究目标是当前暴露,应使用最新披露并结合指数成分;若用于历史回测,必须使用当时已披露的持仓。
典型用法
常见问题
ETF 持仓数据是实时的吗?
不是。持仓明细来自定期报告,存在披露滞后;PCF 清单按日更新,但也不等同于实时持仓。
NAV 与 IOPV 有什么区别?
NAV 是基金单位净值,通常在收盘后计算;IOPV 是盘中参考净值,由数据供应商估算,用于观察盘中折溢价。
折溢价率应该用哪个价格计算?
常见做法是用二级市场价格相对 NAV 或 IOPV。两者含义不同,应在研究中明确口径并保持一致。
LOF 也有 PCF 吗?
LOF 的申赎机制与 ETF 不同,PCF 字段可用性取决于基金与数据披露。接入前应确认基金类型与字段范围。