finchx 1.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (163) hide show
  1. finchx/__init__.py +12 -0
  2. finchx/client.py +986 -0
  3. finchx/collector.py +99 -0
  4. finchx/collectors/__init__.py +109 -0
  5. finchx/collectors/core.py +1723 -0
  6. finchx/collectors/errors.py +140 -0
  7. finchx/computed/__init__.py +31 -0
  8. finchx/computed/deviation.py +576 -0
  9. finchx/config.py +1 -0
  10. finchx/contracts/__init__.py +45 -0
  11. finchx/contracts/dataset.py +14 -0
  12. finchx/contracts/models.py +149 -0
  13. finchx/contracts/status.py +14 -0
  14. finchx/contracts/units.py +105 -0
  15. finchx/datasets/__init__.py +403 -0
  16. finchx/datasets/company_executive_share_change.py +81 -0
  17. finchx/datasets/company_executive_snapshot.py +79 -0
  18. finchx/datasets/corporate_action_dividend.py +91 -0
  19. finchx/datasets/corporate_action_repurchase.py +85 -0
  20. finchx/datasets/definition.py +40 -0
  21. finchx/datasets/disclosure.py +324 -0
  22. finchx/datasets/document_common.py +168 -0
  23. finchx/datasets/financial_statement.py +178 -0
  24. finchx/datasets/fundamental_common.py +81 -0
  25. finchx/datasets/fundamental_company_profile.py +106 -0
  26. finchx/datasets/fundamental_financial_summary.py +140 -0
  27. finchx/datasets/fundamental_industry_comparison.py +169 -0
  28. finchx/datasets/fundamental_revenue_breakdown.py +125 -0
  29. finchx/datasets/instrument.py +175 -0
  30. finchx/datasets/market_breadth.py +186 -0
  31. finchx/datasets/market_broken_limit_pool.py +163 -0
  32. finchx/datasets/market_consecutive_limit_up.py +198 -0
  33. finchx/datasets/market_daily_replay.py +213 -0
  34. finchx/datasets/market_dragon_tiger.py +318 -0
  35. finchx/datasets/market_fund_flow.py +443 -0
  36. finchx/datasets/market_industry_comparison.py +188 -0
  37. finchx/datasets/market_instrument_sector_snapshot.py +184 -0
  38. finchx/datasets/market_intraday.py +400 -0
  39. finchx/datasets/market_klines.py +240 -0
  40. finchx/datasets/market_limit_down_pool.py +159 -0
  41. finchx/datasets/market_limit_up_pool.py +165 -0
  42. finchx/datasets/market_orderbook.py +161 -0
  43. finchx/datasets/market_quote.py +220 -0
  44. finchx/datasets/market_quote_snapshot.py +259 -0
  45. finchx/datasets/market_ranking.py +184 -0
  46. finchx/datasets/market_sentiment.py +213 -0
  47. finchx/datasets/market_stock_keyword.py +180 -0
  48. finchx/datasets/market_strong_pool.py +160 -0
  49. finchx/datasets/market_yesterday_limit_up_pool.py +156 -0
  50. finchx/datasets/news.py +317 -0
  51. finchx/datasets/ownership_capital_snapshot.py +65 -0
  52. finchx/datasets/ownership_float_holder.py +136 -0
  53. finchx/datasets/ownership_holder_summary_snapshot.py +80 -0
  54. finchx/datasets/trading_calendar.py +152 -0
  55. finchx/datasets/trading_calendar_service.py +90 -0
  56. finchx/entities/__init__.py +24 -0
  57. finchx/entities/instrument.py +39 -0
  58. finchx/entities/symbols.py +171 -0
  59. finchx/health/__init__.py +305 -0
  60. finchx/observability.py +276 -0
  61. finchx/providers/__init__.py +99 -0
  62. finchx/providers/aigupiao_market_intelligence.py +613 -0
  63. finchx/providers/eastmoney_disclosure.py +13 -0
  64. finchx/providers/eastmoney_documents.py +715 -0
  65. finchx/providers/eastmoney_market.py +775 -0
  66. finchx/providers/eastmoney_news.py +9 -0
  67. finchx/providers/eastmoney_stock_keyword.py +254 -0
  68. finchx/providers/errors.py +14 -0
  69. finchx/providers/http.py +74 -0
  70. finchx/providers/instrument.py +43 -0
  71. finchx/providers/jiuyangongshe_replay.py +435 -0
  72. finchx/providers/market_klines.py +18 -0
  73. finchx/providers/market_news.py +437 -0
  74. finchx/providers/market_quote.py +24 -0
  75. finchx/providers/market_ranking.py +24 -0
  76. finchx/providers/registry.py +459 -0
  77. finchx/providers/sohu_klines.py +286 -0
  78. finchx/providers/tencent.py +727 -0
  79. finchx/providers/tencent_f10.py +831 -0
  80. finchx/providers/tencent_float_holder.py +340 -0
  81. finchx/providers/tencent_fund_flow.py +581 -0
  82. finchx/providers/tencent_industry.py +210 -0
  83. finchx/providers/tencent_intraday.py +415 -0
  84. finchx/providers/tencent_klines.py +334 -0
  85. finchx/providers/tencent_quote.py +201 -0
  86. finchx/providers/tencent_sector.py +197 -0
  87. finchx/providers/tonghuashun_financial.py +150 -0
  88. finchx/providers/trading_calendar.py +354 -0
  89. finchx/quality.py +525 -0
  90. finchx/query/__init__.py +12 -0
  91. finchx/query/documents.py +245 -0
  92. finchx/query/financial.py +57 -0
  93. finchx/query/market_news.py +235 -0
  94. finchx/schemas/__init__.py +54 -0
  95. finchx/schemas/v1/company-executive-share-change.schema.json +25 -0
  96. finchx/schemas/v1/company-executive-snapshot.schema.json +25 -0
  97. finchx/schemas/v1/corporate-action-dividend.schema.json +30 -0
  98. finchx/schemas/v1/corporate-action-repurchase.schema.json +27 -0
  99. finchx/schemas/v1/disclosure-document-ref.schema.json +60 -0
  100. finchx/schemas/v1/disclosure-document.schema.json +51 -0
  101. finchx/schemas/v1/examples/standard-record.json +32 -0
  102. finchx/schemas/v1/examples/status-estimated.json +17 -0
  103. finchx/schemas/v1/examples/status-failed.json +12 -0
  104. finchx/schemas/v1/examples/status-missing.json +12 -0
  105. finchx/schemas/v1/financial-statement.schema.json +39 -0
  106. finchx/schemas/v1/fundamental-company-profile.schema.json +15 -0
  107. finchx/schemas/v1/fundamental-financial-summary.schema.json +36 -0
  108. finchx/schemas/v1/fundamental-industry-comparison.schema.json +31 -0
  109. finchx/schemas/v1/fundamental-revenue-breakdown.schema.json +30 -0
  110. finchx/schemas/v1/instrument-identity.schema.json +20 -0
  111. finchx/schemas/v1/instrument.schema.json +14 -0
  112. finchx/schemas/v1/market-breadth.schema.json +128 -0
  113. finchx/schemas/v1/market-broken-limit-pool.schema.json +219 -0
  114. finchx/schemas/v1/market-consecutive-limit-up-snapshot.schema.json +237 -0
  115. finchx/schemas/v1/market-daily-replay.schema.json +262 -0
  116. finchx/schemas/v1/market-deviation.schema.json +83 -0
  117. finchx/schemas/v1/market-dragon-tiger-detail.schema.json +278 -0
  118. finchx/schemas/v1/market-dragon-tiger-list.schema.json +188 -0
  119. finchx/schemas/v1/market-equity-intraday-5d.schema.json +134 -0
  120. finchx/schemas/v1/market-equity-intraday.schema.json +134 -0
  121. finchx/schemas/v1/market-fund-flow-daily.schema.json +106 -0
  122. finchx/schemas/v1/market-fund-flow-intraday.schema.json +203 -0
  123. finchx/schemas/v1/market-fund-flow-snapshot.schema.json +249 -0
  124. finchx/schemas/v1/market-index-intraday-5d.schema.json +160 -0
  125. finchx/schemas/v1/market-index-intraday.schema.json +160 -0
  126. finchx/schemas/v1/market-industry-comparison.schema.json +56 -0
  127. finchx/schemas/v1/market-instrument-sector-snapshot.schema.json +28 -0
  128. finchx/schemas/v1/market-klines.schema.json +59 -0
  129. finchx/schemas/v1/market-limit-down-pool.schema.json +234 -0
  130. finchx/schemas/v1/market-limit-up-pool.schema.json +234 -0
  131. finchx/schemas/v1/market-orderbook.schema.json +115 -0
  132. finchx/schemas/v1/market-quote-snapshot.schema.json +227 -0
  133. finchx/schemas/v1/market-quote.schema.json +204 -0
  134. finchx/schemas/v1/market-ranking.schema.json +339 -0
  135. finchx/schemas/v1/market-sentiment-snapshot.schema.json +227 -0
  136. finchx/schemas/v1/market-stock-keyword.schema.json +26 -0
  137. finchx/schemas/v1/market-strong-pool.schema.json +219 -0
  138. finchx/schemas/v1/market-yesterday-limit-up-pool.schema.json +196 -0
  139. finchx/schemas/v1/news-document-ref.schema.json +61 -0
  140. finchx/schemas/v1/news-document.schema.json +40 -0
  141. finchx/schemas/v1/ownership-capital-snapshot.schema.json +13 -0
  142. finchx/schemas/v1/ownership-float-holder.schema.json +42 -0
  143. finchx/schemas/v1/ownership-holder-summary-snapshot.schema.json +16 -0
  144. finchx/schemas/v1/provenance.schema.json +44 -0
  145. finchx/schemas/v1/quality.schema.json +28 -0
  146. finchx/schemas/v1/source-reference.schema.json +23 -0
  147. finchx/schemas/v1/source.schema.json +23 -0
  148. finchx/schemas/v1/standard-record.schema.json +130 -0
  149. finchx/schemas/v1/trading-calendar.schema.json +21 -0
  150. finchx/schemas/v1/units.schema.json +76 -0
  151. finchx/storage/__init__.py +34 -0
  152. finchx/storage/cache.py +181 -0
  153. finchx/storage/errors.py +40 -0
  154. finchx/storage/memory.py +69 -0
  155. finchx/storage/models.py +210 -0
  156. finchx/storage/protocol.py +49 -0
  157. finchx/storage/serialization.py +224 -0
  158. finchx/storage/sqlite.py +250 -0
  159. finchx-1.0.0.dist-info/METADATA +438 -0
  160. finchx-1.0.0.dist-info/RECORD +163 -0
  161. finchx-1.0.0.dist-info/WHEEL +5 -0
  162. finchx-1.0.0.dist-info/licenses/LICENSE +201 -0
  163. finchx-1.0.0.dist-info/top_level.txt +1 -0
finchx/__init__.py ADDED
@@ -0,0 +1,12 @@
1
+ """FinchX: an independent Python package for A-share market data."""
2
+
3
+ __version__ = "1.0.0"
4
+
5
+ from finchx.collector import Collector
6
+ from finchx.client import CLIENT_ENDPOINTS, FinchX
7
+ from finchx.query import (
8
+ DisclosureService, FinancialStatementService, MarketNewsService, NewsService,
9
+ disclosure, financial_statements, market_news, news,
10
+ )
11
+
12
+ __all__ = ["Collector", "FinchX", "CLIENT_ENDPOINTS", "DisclosureService", "FinancialStatementService", "MarketNewsService", "NewsService", "disclosure", "financial_statements", "market_news", "news", "__version__"]