chstockdata 0.4.2__tar.gz → 0.4.3__tar.gz

{chstockdata-0.4.2/src/chstockdata.egg-info → chstockdata-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chstockdata
-Version: 0.4.2
+Version: 0.4.3
 Summary: Free China A-share market data toolkit: direct HTTP/TCP vendors (Tencent, mootdx/TDX, Eastmoney, Sina, THS, CLS, SSE/SZSE), no API keys, no mandatory third-party market-data SDK in the core path; optional mootdx/baostock integrations
 Author: joycoding2000
 License:                                  Apache License
@@ -275,7 +275,18 @@ df = get_stock_data("600519", 365)    # daily OHLCV, vipdoc/mootdx/Sina chain
 get_realtime_snapshot("600519")       # realtime quote, Tencent -> mootdx -> Sina
 ```
 
-## Structured API（v0.4.1 release candidate）
+Version 0.4.3 adds the Owner-accepted DR04-P public API
+`get_sina_daily_fund_flow` and the public `FundFlowCalendar`, `FundFlowBudget`
+and `DailyFundFlowResult` types for lossless Sina daily `r0_net` observations.
+Install with `python -m pip install chstockdata==0.4.3`.
+See the [consumer contract and usage](docs/dr04-p-daily-fund-flow.md) and
+[v0.4.3 release notes](docs/releases/v0.4.3.md).
+Consumers supply a qualified trading calendar and explicit request budget.
+Numeric completeness does not establish zero-value semantics, source finality,
+historical PIT, full-market coverage or strategy qualification; DR04-M remains
+outside this release.
+
+## Structured API (v0.4.2)
 
 The structured surface is additive and returns `FetchResult` objects. The
 quote route keeps its provider functions injectable; `quote_fetchers` below is
@@ -333,8 +344,36 @@ hot rank / popularity rank / concept hits, insider transactions, shareholder
 pledge / buyback, corporate actions, earnings forecast, research reports, news
 wires, policy news, macro indicators, trading calendar, delisting / suspension
 info, and more. See `chstockdata/__init__.py` for the full export list. The
-candidate package version is `0.4.1`; `0.3.0` is the prior consumer
-compatibility baseline. This release candidate has not been published.
+current release version is `0.4.3`
+([PyPI](https://pypi.org/project/chstockdata/0.4.3/) /
+[GitHub Release](https://github.com/joycoding2000/chstockdata/releases/tag/v0.4.3)).
+The structured API is additive: it does not deprecate the legacy API.
+`0.3.0` remains the formal compatibility baseline for existing consumers
+that have not yet migrated; migration is not assumed.
+
+### Historical capability boundaries
+
+Suspension data is a current-day snapshot of the Eastmoney latest-event
+list, not a historical as-of database. Historical and future dates fail
+closed (`failed_structure`, limitation `historical_suspension_unavailable`):
+an empty or non-matching latest-event response — including a cached one —
+never proves that a security was tradable on a past date.
+`fetch_tradability` returns `tradable=True` only on an explicit suspension
+negative (`suspended=False` under a success / normal-empty status); missing
+or unusable suspension evidence stays `tradable=None`
+(`suspension_unknown`). A complete historical point-in-time suspension
+database is not provided in this release.
+
+`fetch_historical_opening_evidence` (policy `R2.1`) is a bounded opening
+execution evidence capability exported in v0.4.2. Consumers — for example
+SIOS, which uses it only in its explicitly selected `HISTORICAL_OPENING_R21`
+mode — opt in deliberately. It reports positive trading activity in the
+Asia/Shanghai `[09:30:00, 09:31:00)` window together with certified official
+halt events. It does not guarantee that a specific order filled at exactly
+09:30:00, and it says nothing about order queue position or individual fill
+probability. It does not replace complete historical PIT suspension coverage:
+certified official vetoes and source conflicts still force `UNKNOWN` or
+blocked results, and missing evidence stays fail-closed.
 
 ## Data sources
 

{chstockdata-0.4.2 → chstockdata-0.4.3}/README.md

@@ -30,7 +30,18 @@ df = get_stock_data("600519", 365)    # daily OHLCV, vipdoc/mootdx/Sina chain
 get_realtime_snapshot("600519")       # realtime quote, Tencent -> mootdx -> Sina
 ```
 
-## Structured API（v0.4.1 release candidate）
+Version 0.4.3 adds the Owner-accepted DR04-P public API
+`get_sina_daily_fund_flow` and the public `FundFlowCalendar`, `FundFlowBudget`
+and `DailyFundFlowResult` types for lossless Sina daily `r0_net` observations.
+Install with `python -m pip install chstockdata==0.4.3`.
+See the [consumer contract and usage](docs/dr04-p-daily-fund-flow.md) and
+[v0.4.3 release notes](docs/releases/v0.4.3.md).
+Consumers supply a qualified trading calendar and explicit request budget.
+Numeric completeness does not establish zero-value semantics, source finality,
+historical PIT, full-market coverage or strategy qualification; DR04-M remains
+outside this release.
+
+## Structured API (v0.4.2)
 
 The structured surface is additive and returns `FetchResult` objects. The
 quote route keeps its provider functions injectable; `quote_fetchers` below is
@@ -88,8 +99,36 @@ hot rank / popularity rank / concept hits, insider transactions, shareholder
 pledge / buyback, corporate actions, earnings forecast, research reports, news
 wires, policy news, macro indicators, trading calendar, delisting / suspension
 info, and more. See `chstockdata/__init__.py` for the full export list. The
-candidate package version is `0.4.1`; `0.3.0` is the prior consumer
-compatibility baseline. This release candidate has not been published.
+current release version is `0.4.3`
+([PyPI](https://pypi.org/project/chstockdata/0.4.3/) /
+[GitHub Release](https://github.com/joycoding2000/chstockdata/releases/tag/v0.4.3)).
+The structured API is additive: it does not deprecate the legacy API.
+`0.3.0` remains the formal compatibility baseline for existing consumers
+that have not yet migrated; migration is not assumed.
+
+### Historical capability boundaries
+
+Suspension data is a current-day snapshot of the Eastmoney latest-event
+list, not a historical as-of database. Historical and future dates fail
+closed (`failed_structure`, limitation `historical_suspension_unavailable`):
+an empty or non-matching latest-event response — including a cached one —
+never proves that a security was tradable on a past date.
+`fetch_tradability` returns `tradable=True` only on an explicit suspension
+negative (`suspended=False` under a success / normal-empty status); missing
+or unusable suspension evidence stays `tradable=None`
+(`suspension_unknown`). A complete historical point-in-time suspension
+database is not provided in this release.
+
+`fetch_historical_opening_evidence` (policy `R2.1`) is a bounded opening
+execution evidence capability exported in v0.4.2. Consumers — for example
+SIOS, which uses it only in its explicitly selected `HISTORICAL_OPENING_R21`
+mode — opt in deliberately. It reports positive trading activity in the
+Asia/Shanghai `[09:30:00, 09:31:00)` window together with certified official
+halt events. It does not guarantee that a specific order filled at exactly
+09:30:00, and it says nothing about order queue position or individual fill
+probability. It does not replace complete historical PIT suspension coverage:
+certified official vetoes and source conflicts still force `UNKNOWN` or
+blocked results, and missing evidence stays fail-closed.
 
 ## Data sources
 

{chstockdata-0.4.2 → chstockdata-0.4.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "chstockdata"
-version = "0.4.2"
+version = "0.4.3"
 description = "Free China A-share market data toolkit: direct HTTP/TCP vendors (Tencent, mootdx/TDX, Eastmoney, Sina, THS, CLS, SSE/SZSE), no API keys, no mandatory third-party market-data SDK in the core path; optional mootdx/baostock integrations"
 readme = "README.md"
 license = { file = "LICENSE" }

{chstockdata-0.4.2 → chstockdata-0.4.3}/src/chstockdata/__init__.py

@@ -85,6 +85,12 @@ from .a_stock import (
 
 # ── Reversed-ported upstream endpoints (v0.2.0) ─────────────────────────────
 from .board_flow import get_board_fund_flow
+from .daily_fund_flow import (
+    DailyFundFlowResult,
+    FundFlowBudget,
+    FundFlowCalendar,
+    get_sina_daily_fund_flow,
+)
 from .chips import chip_distribution, get_chip_distribution
 from .etf_options import (
     get_etf_option_chain,
@@ -168,7 +174,7 @@ from .delisting import fetch_delisting_status
 from .tradability import fetch_tradability
 from .opening_evidence import fetch_historical_opening_evidence, OfficialOpeningEvent
 
-__version__ = "0.4.2"
+__version__ = "0.4.3"
 
 __all__ = [
     # config
@@ -195,6 +201,7 @@ __all__ = [
     "get_corporate_buyback",
     # money flow / microstructure
     "get_fund_flow", "get_dragon_tiger_board", "get_block_trades",
+    "get_sina_daily_fund_flow", "DailyFundFlowResult", "FundFlowBudget", "FundFlowCalendar",
     "get_northbound_flow", "get_market_breadth", "get_margin_trading",
     "get_valuation_history", "get_industry_comparison", "get_concept_blocks",
     "get_daily_dragon_tiger", "get_board_fund_flow",