# SoSoValue今天净流入为何为空？核T+1、ETF历史字段与已结算快照

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/sosovalue-etf-t1-history-null-volume-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

把待结算null、非交易日、错误和真实零值分开，并保留history.volume已知问题。

## 使用工具
- [SoSoValue](https://lianxiaozhi.com/tools/sosovalue) · [官方入口](https://sosovalue.com/)

## 前置条件
- 准备自己已有的脱敏材料与请求参数，保留产品、日期、单位和权限说明；缺值不补零。

## 1. 固定API与ETF对象

本篇是v1 Market Data的ETF模块：summary-history为资产/国家汇总，history与market-snapshot按ETF ticker。业务要x-soso-api-key；已读v1限额20次/分钟/key及100,000次/月，429看retry_after，X-RateLimit-Reset为Unix毫秒。网页可免费读不代表API匿名，也不把此额度套不同v3 API。

核对结果：ticker与底层symbol、country和接口版本分开；key与个人信息不进入核对表。
依据：[SoSoValue Market Data：v1认证、额度与错误](https://sodex.com/documentation/for-developers/developers/data-api/authentication-and-limits.md)
依据：[SoSoValue：ETF模块](https://sosovalue-1.gitbook.io/sosovalue-api-doc/2.-etf/etf.md)

## 2. 按国家/资产和一月窗口核范围

summary-history的symbol不区分大小写，US支持BTC/ETH/SOL/LTC/HBAR/XRP/DOGE/LINK/AVAX/DOT，HK仅BTC/ETH/SOL。无效symbol如FOO为400003，合法但未在当地上市的LTC+HK为400001；两者都不是零流入。summary与单ticker history只支持最近1个月；summary默认limit50、最大300，倒序且排除周末/假日。增加limit不能突破历史权限。

核对结果：资产、上市地、日期范围、limit及非交易日有依据；错误没有当零事件。
依据：[SoSoValue：ETF汇总历史与国家/资产组合](https://sosovalue-1.gitbook.io/sosovalue-api-doc/2.-etf/summary-history.md)
依据：[SoSoValue：单ETF历史、T+1与volume已知问题](https://sosovalue-1.gitbook.io/sosovalue-api-doc/2.-etf/history.md)

## 3. 最新行null先判T+1而非无资金流

history当前交易日可已有value_traded/volume，但net_inflow、cum_inflow、net_assets、currency_share、prem_dsc仍null，流入与资产数按T+1结算。不能机械取data[0]当最新净流入，也不能把null填0；官方可跳过net_inflow为null的行，或用market-snapshot取得最新已结算值。保留那个已结算值自己的date，不能挂在今天日期上。

核对结果：待结算、最新已结算及读取时点分列；缺行/null/0保持不同。
依据：[SoSoValue：单ETF历史、T+1与volume已知问题](https://sosovalue-1.gitbook.io/sosovalue-api-doc/2.-etf/history.md)
依据：[SoSoValue：最新已结算ETF快照](https://sosovalue-1.gitbook.io/sosovalue-api-doc/2.-etf/market-snapshot.md)

## 4. volume、date与费用比例按端点辨字段

history文档明确当前volume与value_traded一样是美元成交额，且以JSON字符串返回，不是份额数量；份额volume应核snapshot。history.date为YYYY-MM-DD，snapshot表称Long timestamp但样例又是日期字符串，该差异保留，不统一强转成毫秒。sponsor_fee及prem_dsc是独立费率/溢折价字段，不当资金流或美元金额。

核对结果：volume的单位/类型与date原形有记录；没有把历史成交额当份额或臆测date格式。
依据：[SoSoValue：单ETF历史、T+1与volume已知问题](https://sosovalue-1.gitbook.io/sosovalue-api-doc/2.-etf/history.md)
依据：[SoSoValue：最新已结算ETF快照](https://sosovalue-1.gitbook.io/sosovalue-api-doc/2.-etf/market-snapshot.md)

## 5. 汇总净流入与累计数分别收口

summary的total_net_inflow是当天所有该类别ETF美元净流入，负值为净流出；total_value_traded是美元成交额，total_net_assets为净资产，cum_net_inflow为推出以来累计净流入。不能把累计数每天再相加，也不把成交额/净资产当流入。单ticker与汇总要对齐类别与已结算日期，缺单基金披露/原材料时只报告已知范围，不凭差异判断一方错误。

核对结果：每日净额、累计额、净资产与成交额单位/日期一致，未输出缺材料的完整汇总。
依据：[SoSoValue：ETF汇总历史与国家/资产组合](https://sosovalue-1.gitbook.io/sosovalue-api-doc/2.-etf/summary-history.md)
依据：[SoSoValue：单ETF历史、T+1与volume已知问题](https://sosovalue-1.gitbook.io/sosovalue-api-doc/2.-etf/history.md)

## 常见错误
- 接口返回交易日数不是自然日数；接口刷新与发行人披露/结算是不同时间。
- 官方已知问题与示例类型冲突保留，不能据示例断言生产字段已修复。

## 完成检查
- 保存对象、原字段、窗口/版本、可核结果与未知分支；文档方法已核，实时数据与本人权限未验证。

## 相关知识

## 官方依据
- [SoSoValue Market Data：v1认证、额度与错误](https://sodex.com/documentation/for-developers/developers/data-api/authentication-and-limits.md)
- [SoSoValue：ETF模块](https://sosovalue-1.gitbook.io/sosovalue-api-doc/2.-etf/etf.md)
- [SoSoValue：ETF汇总历史与国家/资产组合](https://sosovalue-1.gitbook.io/sosovalue-api-doc/2.-etf/summary-history.md)
- [SoSoValue：单ETF历史、T+1与volume已知问题](https://sosovalue-1.gitbook.io/sosovalue-api-doc/2.-etf/history.md)
- [SoSoValue：最新已结算ETF快照](https://sosovalue-1.gitbook.io/sosovalue-api-doc/2.-etf/market-snapshot.md)
