fmp-data 2.8.0__tar.gz → 2.9.0__tar.gz

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 (270) hide show
  1. {fmp_data-2.8.0 → fmp_data-2.9.0}/PKG-INFO +30 -23
  2. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/__init__.py +4 -0
  3. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/_version.py +2 -2
  4. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/base.py +19 -5
  5. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/batch/models.py +3 -1
  6. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/company/client.py +9 -2
  7. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/company/models.py +3 -1
  8. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/economics/async_client.py +3 -2
  9. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/economics/client.py +3 -2
  10. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/exceptions.py +25 -6
  11. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/fundamental/client.py +6 -1
  12. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/index/models.py +8 -1
  13. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/intelligence/async_client.py +189 -0
  14. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/intelligence/client.py +211 -3
  15. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/intelligence/endpoints.py +240 -0
  16. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/intelligence/mapping.py +215 -0
  17. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/intelligence/models.py +138 -2
  18. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/investment/async_client.py +10 -2
  19. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/investment/client.py +15 -3
  20. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/market/async_client.py +3 -2
  21. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/market/client.py +7 -3
  22. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/market/models.py +3 -1
  23. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/mcp/tools_manifest.py +8 -1
  24. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/models.py +4 -0
  25. {fmp_data-2.8.0 → fmp_data-2.9.0}/pyproject.toml +60 -43
  26. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_base.py +21 -3
  27. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_exceptions.py +37 -0
  28. fmp_data-2.9.0/tests/unit/test_fmp_29_surface.py +104 -0
  29. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_setup_uv_pin.py +4 -4
  30. {fmp_data-2.8.0 → fmp_data-2.9.0}/.gitignore +0 -0
  31. {fmp_data-2.8.0 → fmp_data-2.9.0}/LICENSE +0 -0
  32. {fmp_data-2.8.0 → fmp_data-2.9.0}/NOTICE +0 -0
  33. {fmp_data-2.8.0 → fmp_data-2.9.0}/README.md +0 -0
  34. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/_redaction.py +0 -0
  35. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/alternative/__init__.py +0 -0
  36. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/alternative/async_client.py +0 -0
  37. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/alternative/client.py +0 -0
  38. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/alternative/endpoints.py +0 -0
  39. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/alternative/mapping.py +0 -0
  40. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/alternative/models.py +0 -0
  41. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/alternative/schema.py +0 -0
  42. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/async_client.py +0 -0
  43. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/batch/__init__.py +0 -0
  44. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/batch/_csv_utils.py +0 -0
  45. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/batch/async_client.py +0 -0
  46. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/batch/client.py +0 -0
  47. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/batch/endpoints.py +0 -0
  48. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/batch/mapping.py +0 -0
  49. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/cache/__init__.py +0 -0
  50. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/cache/base.py +0 -0
  51. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/cache/config.py +0 -0
  52. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/cache/file.py +0 -0
  53. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/cache/memory.py +0 -0
  54. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/cache/redis_backend.py +0 -0
  55. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/client.py +0 -0
  56. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/company/__init__.py +0 -0
  57. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/company/async_client.py +0 -0
  58. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/company/endpoints.py +0 -0
  59. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/company/hints.py +0 -0
  60. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/company/mapping.py +0 -0
  61. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/company/schema.py +0 -0
  62. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/config.py +0 -0
  63. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/economics/__init__.py +0 -0
  64. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/economics/endpoints.py +0 -0
  65. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/economics/mapping.py +0 -0
  66. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/economics/models.py +0 -0
  67. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/economics/schema.py +0 -0
  68. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/fundamental/__init__.py +0 -0
  69. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/fundamental/async_client.py +0 -0
  70. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/fundamental/endpoints.py +0 -0
  71. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/fundamental/mapping.py +0 -0
  72. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/fundamental/models.py +0 -0
  73. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/fundamental/schema.py +0 -0
  74. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/helpers.py +0 -0
  75. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/index/__init__.py +0 -0
  76. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/index/async_client.py +0 -0
  77. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/index/client.py +0 -0
  78. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/index/endpoints.py +0 -0
  79. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/index/mapping.py +0 -0
  80. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/institutional/__init__.py +0 -0
  81. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/institutional/async_client.py +0 -0
  82. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/institutional/client.py +0 -0
  83. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/institutional/endpoints.py +0 -0
  84. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/institutional/mapping.py +0 -0
  85. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/institutional/models.py +0 -0
  86. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/institutional/schema.py +0 -0
  87. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/intelligence/__init__.py +0 -0
  88. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/intelligence/schema.py +0 -0
  89. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/investment/__init__.py +0 -0
  90. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/investment/endpoints.py +0 -0
  91. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/investment/mapping.py +0 -0
  92. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/investment/models.py +0 -0
  93. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/investment/schema.py +0 -0
  94. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/lc/__init__.py +0 -0
  95. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/lc/config.py +0 -0
  96. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/lc/embedding.py +0 -0
  97. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/lc/hints.py +0 -0
  98. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/lc/mapping.py +0 -0
  99. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/lc/models.py +0 -0
  100. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/lc/registry.py +0 -0
  101. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/lc/utils.py +0 -0
  102. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/lc/validation.py +0 -0
  103. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/lc/vector_store.py +0 -0
  104. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/logger.py +0 -0
  105. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/market/__init__.py +0 -0
  106. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/market/endpoints.py +0 -0
  107. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/market/hints.py +0 -0
  108. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/market/mapping.py +0 -0
  109. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/market/schema.py +0 -0
  110. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/mcp/__init__.py +0 -0
  111. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/mcp/__main__.py +0 -0
  112. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/mcp/_compat.py +0 -0
  113. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/mcp/cli.py +0 -0
  114. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/mcp/discovery.py +0 -0
  115. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/mcp/server.py +0 -0
  116. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/mcp/setup.py +0 -0
  117. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/mcp/tool_loader.py +0 -0
  118. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/mcp/utils.py +0 -0
  119. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/py.typed +0 -0
  120. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/rate_limit.py +0 -0
  121. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/schema.py +0 -0
  122. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/sec/__init__.py +0 -0
  123. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/sec/async_client.py +0 -0
  124. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/sec/client.py +0 -0
  125. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/sec/endpoints.py +0 -0
  126. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/sec/mapping.py +0 -0
  127. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/sec/models.py +0 -0
  128. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/technical/__init__.py +0 -0
  129. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/technical/async_client.py +0 -0
  130. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/technical/client.py +0 -0
  131. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/technical/endpoints.py +0 -0
  132. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/technical/mapping.py +0 -0
  133. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/technical/models.py +0 -0
  134. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/technical/schema.py +0 -0
  135. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/tool_binding.py +0 -0
  136. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/transcripts/__init__.py +0 -0
  137. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/transcripts/async_client.py +0 -0
  138. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/transcripts/client.py +0 -0
  139. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/transcripts/endpoints.py +0 -0
  140. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/transcripts/mapping.py +0 -0
  141. {fmp_data-2.8.0 → fmp_data-2.9.0}/fmp_data/transcripts/models.py +0 -0
  142. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/__init__.py +0 -0
  143. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/e2e/__init__.py +0 -0
  144. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/e2e/harness.py +0 -0
  145. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/e2e/test_client_sweep.py +0 -0
  146. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/e2e/test_live_signatures.py +0 -0
  147. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/examples/__init__.py +0 -0
  148. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/examples/test_examples_smoke.py +0 -0
  149. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/fixtures/provider_optional_parameters.json +0 -0
  150. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/__init__.py +0 -0
  151. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/base.py +0 -0
  152. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/cassette_contracts.json +0 -0
  153. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/conftest.py +0 -0
  154. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_alternative.py +0 -0
  155. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_batch.py +0 -0
  156. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_company.py +0 -0
  157. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_economics.py +0 -0
  158. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_fundamental.py +0 -0
  159. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_index.py +0 -0
  160. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_institutional.py +0 -0
  161. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_intelligence.py +0 -0
  162. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_investment.py +0 -0
  163. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_lc.py +0 -0
  164. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_market.py +0 -0
  165. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_sec.py +0 -0
  166. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_technical.py +0 -0
  167. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/integration/test_transcripts.py +0 -0
  168. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/__init__.py +0 -0
  169. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/conftest.py +0 -0
  170. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/__init__.py +0 -0
  171. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/conftest.py +0 -0
  172. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_config.py +0 -0
  173. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_deprecated_endpoints.py +0 -0
  174. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_embedding.py +0 -0
  175. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_endpoint_based_rules.py +0 -0
  176. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_endpoint_method_coverage.py +0 -0
  177. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_imports.py +0 -0
  178. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_mapping.py +0 -0
  179. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_method_dispatch.py +0 -0
  180. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_models.py +0 -0
  181. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_package_init.py +0 -0
  182. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_provider_optional_tools.py +0 -0
  183. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_tool_schema.py +0 -0
  184. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_utils.py +0 -0
  185. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_validation.py +0 -0
  186. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_validation_registry.py +0 -0
  187. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/lc/test_vector_store.py +0 -0
  188. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_alternative.py +0 -0
  189. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_alternative_coverage.py +0 -0
  190. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_arg_model_deprecation.py +0 -0
  191. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_artifact_action_pins.py +0 -0
  192. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_async_clients.py +0 -0
  193. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_bandit_skips.py +0 -0
  194. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_base_async.py +0 -0
  195. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_base_coverage.py +0 -0
  196. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_batch.py +0 -0
  197. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_bulk_bytes.py +0 -0
  198. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_cache_backends.py +0 -0
  199. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_cache_integration.py +0 -0
  200. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_cache_ttl_override_keys.py +0 -0
  201. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_cassette_contracts.py +0 -0
  202. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_catalog_registration.py +0 -0
  203. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_changelog_headings.py +0 -0
  204. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_checkout_credentials.py +0 -0
  205. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_ci_quality_gates.py +0 -0
  206. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_client.py +0 -0
  207. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_closed_vocabularies.py +0 -0
  208. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_codeql_workflow.py +0 -0
  209. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_company.py +0 -0
  210. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_company_coverage.py +0 -0
  211. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_config.py +0 -0
  212. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_config_secret_serialization.py +0 -0
  213. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_datetime_shadowing.py +0 -0
  214. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_dependabot_action_groups.py +0 -0
  215. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_deprecated_endpoint_flags.py +0 -0
  216. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_deprecated_methods_warn.py +0 -0
  217. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_docs_endpoints_sync.py +0 -0
  218. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_docs_tools_sync.py +0 -0
  219. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_e2e_harness.py +0 -0
  220. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_e2e_sweep.py +0 -0
  221. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_economics.py +0 -0
  222. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_endpoint_registry.py +0 -0
  223. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_example_json_fences.py +0 -0
  224. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_export_dotenv.py +0 -0
  225. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_extras_coverage_gate.py +0 -0
  226. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_fundamental.py +0 -0
  227. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_github_release_notes.py +0 -0
  228. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_helpers.py +0 -0
  229. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_hint_consolidation.py +0 -0
  230. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_hosted_mcp_docs.py +0 -0
  231. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_imports.py +0 -0
  232. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_index.py +0 -0
  233. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_insider_statistics_fractional.py +0 -0
  234. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_institutional.py +0 -0
  235. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_intelligence.py +0 -0
  236. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_investment.py +0 -0
  237. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_list_unwrap.py +0 -0
  238. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_logger.py +0 -0
  239. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_market.py +0 -0
  240. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_mcp.py +0 -0
  241. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_mcp_cli.py +0 -0
  242. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_mcp_config_perms.py +0 -0
  243. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_mcp_entry_point_coherence.py +0 -0
  244. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_mcp_optional_parameters.py +0 -0
  245. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_mcp_setup.py +0 -0
  246. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_mcp_utils.py +0 -0
  247. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_models.py +0 -0
  248. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_param_required_consistency.py +0 -0
  249. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_path_params.py +0 -0
  250. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_provider_optional_parameters.py +0 -0
  251. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_publish_pins.py +0 -0
  252. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_rate_limit.py +0 -0
  253. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_rate_limit_async.py +0 -0
  254. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_rate_limit_coverage.py +0 -0
  255. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_redaction_rules.py +0 -0
  256. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_redis_backend.py +0 -0
  257. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_release_pr_workflow.py +0 -0
  258. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_release_tag_push.py +0 -0
  259. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_sec.py +0 -0
  260. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_secret_scan_ci.py +0 -0
  261. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_security_audit_pins.py +0 -0
  262. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_tag_ancestry_guard.py +0 -0
  263. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_technical.py +0 -0
  264. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_technical_coverage.py +0 -0
  265. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_tool_binding.py +0 -0
  266. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_transcripts.py +0 -0
  267. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_vcr_sanitization.py +0 -0
  268. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_vector_store_error_contract.py +0 -0
  269. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_workflow_permission_isolation.py +0 -0
  270. {fmp_data-2.8.0 → fmp_data-2.9.0}/tests/unit/test_workflow_run_scripts.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: fmp-data
3
- Version: 2.8.0
3
+ Version: 2.9.0
4
4
  Summary: Python client for the Financial Modeling Prep API
5
5
  Project-URL: Homepage, https://github.com/MehdiZare/fmp-data
6
6
  Project-URL: Repository, https://github.com/MehdiZare/fmp-data
@@ -28,45 +28,52 @@ Classifier: Topic :: Office/Business :: Financial
28
28
  Classifier: Topic :: Software Development :: Libraries :: Python Modules
29
29
  Requires-Python: <3.15,>=3.10
30
30
  Requires-Dist: httpx>=0.28.1
31
- Requires-Dist: pydantic>=2.13.5
32
- Requires-Dist: tenacity>=9.1.4
31
+ Requires-Dist: pydantic>=2.14.4
32
+ Requires-Dist: tenacity>=9.2.1
33
33
  Provides-Extra: cache-redis
34
34
  Requires-Dist: redis>=8.1.0; extra == 'cache-redis'
35
35
  Provides-Extra: dev
36
36
  Requires-Dist: bandit[toml]>=1.9.4; extra == 'dev'
37
- Requires-Dist: coverage>=7.16.0; extra == 'dev'
37
+ Requires-Dist: coverage>=7.16.2; (python_version < '3.11') and extra == 'dev'
38
+ Requires-Dist: coverage>=7.17.4; (python_version >= '3.11') and extra == 'dev'
38
39
  Requires-Dist: freezegun>=1.5.5; extra == 'dev'
39
- Requires-Dist: mypy>=2.3.1; extra == 'dev'
40
- Requires-Dist: nox>=2026.8.17; extra == 'dev'
40
+ Requires-Dist: mypy>=2.4.1; extra == 'dev'
41
+ Requires-Dist: nox>=2026.10.20; extra == 'dev'
41
42
  Requires-Dist: pip-audit>=2.10.1; extra == 'dev'
42
- Requires-Dist: pre-commit>=4.6.2; extra == 'dev'
43
- Requires-Dist: pytest-asyncio>=1.4.0; extra == 'dev'
43
+ Requires-Dist: pre-commit>=4.6.2; (python_version < '3.11') and extra == 'dev'
44
+ Requires-Dist: pre-commit>=4.7.0; (python_version >= '3.11') and extra == 'dev'
45
+ Requires-Dist: pytest-asyncio>=1.5.0; extra == 'dev'
44
46
  Requires-Dist: pytest-cov>=7.1.0; extra == 'dev'
45
- Requires-Dist: pytest-mock>=3.15.1; extra == 'dev'
47
+ Requires-Dist: pytest-mock>=3.17.0; extra == 'dev'
46
48
  Requires-Dist: pytest-xdist>=3.8.0; extra == 'dev'
47
- Requires-Dist: pytest>=9.1.1; extra == 'dev'
48
- Requires-Dist: python-dotenv>=1.2.3; extra == 'dev'
49
+ Requires-Dist: pytest>=9.2.0; extra == 'dev'
50
+ Requires-Dist: python-dotenv>=1.2.4; extra == 'dev'
49
51
  Requires-Dist: responses>=0.26.3; extra == 'dev'
50
52
  Requires-Dist: rich>=15.0.0; extra == 'dev'
51
- Requires-Dist: ruff>=0.16.7; extra == 'dev'
53
+ Requires-Dist: ruff>=0.17.6; extra == 'dev'
52
54
  Requires-Dist: twine>=7.0.0; extra == 'dev'
53
- Requires-Dist: vcrpy>=8.3.0; extra == 'dev'
55
+ Requires-Dist: vcrpy>=8.5.0; (python_version < '3.11') and extra == 'dev'
56
+ Requires-Dist: vcrpy>=9.4.2; (python_version >= '3.11') and extra == 'dev'
54
57
  Provides-Extra: docs
55
- Requires-Dist: mkdocs-material>=9.7.7; extra == 'docs'
58
+ Requires-Dist: mkdocs-material>=9.7.7; (python_version < '3.11') and extra == 'docs'
59
+ Requires-Dist: mkdocs-material>=9.8.2; (python_version >= '3.11') and extra == 'docs'
56
60
  Requires-Dist: mkdocs>=1.6.1; extra == 'docs'
57
- Requires-Dist: mkdocstrings-python>=2.0.8; extra == 'docs'
61
+ Requires-Dist: mkdocstrings-python>=2.0.11; (python_version >= '3.11') and extra == 'docs'
62
+ Requires-Dist: mkdocstrings-python>=2.0.9; (python_version < '3.11') and extra == 'docs'
58
63
  Provides-Extra: langchain
59
- Requires-Dist: faiss-cpu>=1.15.0; extra == 'langchain'
64
+ Requires-Dist: faiss-cpu>=1.16.0; extra == 'langchain'
60
65
  Requires-Dist: langchain-community>=0.4.2; extra == 'langchain'
61
- Requires-Dist: langchain-core>=1.6.3; extra == 'langchain'
62
- Requires-Dist: langchain-openai>=1.6.2; extra == 'langchain'
63
- Requires-Dist: langgraph>=1.2.11; extra == 'langchain'
64
- Requires-Dist: openai>=3.13.0; extra == 'langchain'
66
+ Requires-Dist: langchain-core>=1.7.7; (python_version < '3.11') and extra == 'langchain'
67
+ Requires-Dist: langchain-core>=1.8.4; (python_version >= '3.11') and extra == 'langchain'
68
+ Requires-Dist: langchain-openai>=1.7.4; (python_version < '3.11') and extra == 'langchain'
69
+ Requires-Dist: langchain-openai>=1.8.5; (python_version >= '3.11') and extra == 'langchain'
70
+ Requires-Dist: langgraph>=1.2.24; extra == 'langchain'
71
+ Requires-Dist: openai>=3.57.0; extra == 'langchain'
65
72
  Requires-Dist: tiktoken>=0.14.0; extra == 'langchain'
66
73
  Provides-Extra: mcp
67
- Requires-Dist: mcp[cli]>=2.2.0; extra == 'mcp'
68
- Requires-Dist: pyyaml>=6.0.3; extra == 'mcp'
69
- Requires-Dist: tomli>=2.4.1; (python_version < '3.11') and extra == 'mcp'
74
+ Requires-Dist: mcp[cli]>=2.3.0; extra == 'mcp'
75
+ Requires-Dist: pyyaml>=6.0.4; extra == 'mcp'
76
+ Requires-Dist: tomli>=2.5.0; (python_version < '3.11') and extra == 'mcp'
70
77
  Description-Content-Type: text/markdown
71
78
 
72
79
  # FMP Data Client
@@ -30,9 +30,11 @@ from fmp_data.config import (
30
30
  from fmp_data.exceptions import (
31
31
  AuthenticationError,
32
32
  ConfigError,
33
+ FMPAPIError,
33
34
  FMPError,
34
35
  FMPNetworkError,
35
36
  FMPTimeoutError,
37
+ FMPTransportError,
36
38
  RateLimitError,
37
39
  ValidationError,
38
40
  VectorStoreCreationError,
@@ -64,11 +66,13 @@ __all__ = [
64
66
  "CacheConfig",
65
67
  "ClientConfig",
66
68
  "ConfigError",
69
+ "FMPAPIError",
67
70
  "FMPDataClient",
68
71
  "FMPError",
69
72
  "FMPLogger",
70
73
  "FMPNetworkError",
71
74
  "FMPTimeoutError",
75
+ "FMPTransportError",
72
76
  "Interval",
73
77
  "LogHandlerConfig",
74
78
  "LoggingConfig",
@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
18
18
  commit_id: str | None
19
19
  __commit_id__: str | None
20
20
 
21
- __version__ = version = '2.8.0'
22
- __version_tuple__ = version_tuple = (2, 8, 0)
21
+ __version__ = version = '2.9.0'
22
+ __version_tuple__ = version_tuple = (2, 9, 0)
23
23
 
24
24
  __commit_id__ = commit_id = None
@@ -29,6 +29,7 @@ from fmp_data.cache.base import CacheBackend
29
29
  from fmp_data.config import ClientConfig
30
30
  from fmp_data.exceptions import (
31
31
  AuthenticationError,
32
+ FMPAPIError,
32
33
  FMPError,
33
34
  FMPNetworkError,
34
35
  FMPTimeoutError,
@@ -882,13 +883,26 @@ class BaseClient:
882
883
  extra={"endpoint": endpoint_name, "status_code": status_code},
883
884
  )
884
885
  return []
885
- if isinstance(error_details, list) and not error_details:
886
+ normalize_empty = True
887
+ if endpoint is not None:
888
+ normalize_empty = bool(
889
+ getattr(endpoint, "normalize_empty_404_body", True)
890
+ )
891
+ if (
892
+ normalize_empty
893
+ and isinstance(error_details, list)
894
+ and not error_details
895
+ ):
886
896
  self.logger.warning(
887
897
  "Received 404 with empty list payload; returning empty list.",
888
898
  extra={"status_code": status_code},
889
899
  )
890
900
  return []
891
- if isinstance(error_details, dict) and not error_details:
901
+ if (
902
+ normalize_empty
903
+ and isinstance(error_details, dict)
904
+ and not error_details
905
+ ):
892
906
  self.logger.warning(
893
907
  "Received 404 with empty object payload; returning empty object.",
894
908
  extra={"status_code": status_code},
@@ -940,7 +954,7 @@ class BaseClient:
940
954
  response=error_details,
941
955
  ) from None
942
956
 
943
- raise FMPError(
957
+ raise FMPAPIError(
944
958
  f"HTTP {status_code} error occurred: {error_details}",
945
959
  status_code=status_code,
946
960
  response=error_details,
@@ -956,7 +970,7 @@ class BaseClient:
956
970
  Raises:
957
971
  AuthenticationError: If the body is the known invalid-key copy
958
972
  on a 2xx response (#340).
959
- FMPError: If any other error message is found in the data
973
+ FMPAPIError: If any other error message is found in the data
960
974
  """
961
975
  for key in _ERROR_BODY_KEY_ORDER:
962
976
  if key in data:
@@ -968,7 +982,7 @@ class BaseClient:
968
982
  text = _error_body_text(message)
969
983
  if _is_invalid_api_key_text(text):
970
984
  raise AuthenticationError(text, status_code=200)
971
- raise FMPError(text)
985
+ raise FMPAPIError(text)
972
986
 
973
987
  @staticmethod
974
988
  def _raise_decorator_invalid_key(item: dict[str, Any]) -> None:
@@ -34,7 +34,9 @@ class BatchQuote(BaseModel):
34
34
  year_high: float | None = Field(None, alias="yearHigh", description="52-week high")
35
35
  year_low: float | None = Field(None, alias="yearLow", description="52-week low")
36
36
  market_cap: float | None = Field(
37
- None, alias="marketCap", description="Market capitalization"
37
+ None,
38
+ alias="marketCap",
39
+ description="Market capitalization as a whole number",
38
40
  )
39
41
  price_avg_50: float | None = Field(
40
42
  None, alias="priceAvg50", description="50-day moving average"
@@ -633,7 +633,11 @@ class CompanyClient(EndpointGroup):
633
633
  return None
634
634
 
635
635
  def get_company_peers(self, symbol: str) -> list[CompanyPeer]:
636
- """Get company peers"""
636
+ """Get company peers.
637
+
638
+ Peer market caps use the same reporting units as the rest of the API,
639
+ including subunit-quoted currencies such as pence.
640
+ """
637
641
  return self._unwrap_list(
638
642
  self.client.request(COMPANY_PEERS, symbol=symbol), CompanyPeer
639
643
  )
@@ -960,7 +964,10 @@ class CompanyClient(EndpointGroup):
960
964
  )
961
965
 
962
966
  def get_financial_scores(self, symbol: str) -> list[FinancialScore]:
963
- """Get comprehensive financial health scores
967
+ """Get comprehensive financial health scores.
968
+
969
+ Semi-annual reporters are included. The asset-turnover signal is
970
+ counted only when a full prior year is available.
964
971
 
965
972
  Args:
966
973
  symbol: Stock symbol (e.g., 'AAPL')
@@ -362,7 +362,9 @@ class Quote(BaseModel):
362
362
  year_high: float | None = Field(None, alias="yearHigh", description="52-week high")
363
363
  year_low: float | None = Field(None, alias="yearLow", description="52-week low")
364
364
  market_cap: float | None = Field(
365
- None, alias="marketCap", description="Market capitalization"
365
+ None,
366
+ alias="marketCap",
367
+ description="Market capitalization as a whole number",
366
368
  )
367
369
  price_avg_50: float | None = Field(
368
370
  None, alias="priceAvg50", description="50-day average price"
@@ -56,8 +56,9 @@ class AsyncEconomicsClient(AsyncEndpointGroup):
56
56
 
57
57
  Args:
58
58
  indicator_name: FMP economic indicator name, for example "GDP".
59
- start_date: Start date passed to FMP; boundary semantics depend on the
60
- endpoint.
59
+ start_date: Start date passed to FMP as ``from``. Omitted when None.
60
+ With no start date, FMP returns about the most recent three
61
+ months rather than twelve.
61
62
  end_date: End date passed to FMP; boundary semantics depend on the
62
63
  endpoint.
63
64
 
@@ -54,8 +54,9 @@ class EconomicsClient(EndpointGroup):
54
54
 
55
55
  Args:
56
56
  indicator_name: FMP economic indicator name, for example "GDP".
57
- start_date: Start date passed to FMP; boundary semantics depend on the
58
- endpoint.
57
+ start_date: Start date passed to FMP as ``from``. Omitted when None.
58
+ With no start date, FMP returns about the most recent three
59
+ months rather than twelve.
59
60
  end_date: End date passed to FMP; boundary semantics depend on the
60
61
  endpoint.
61
62
 
@@ -17,11 +17,30 @@ class FMPError(Exception):
17
17
  super().__init__(self.message)
18
18
 
19
19
 
20
- class FMPTimeoutError(FMPError):
20
+ class FMPTransportError(FMPError):
21
+ """Raised when FMP was not reached.
22
+
23
+ Parent of :class:`FMPTimeoutError` and :class:`FMPNetworkError`. Catch
24
+ this before a degrading ``except FMPError`` when an outage must abort
25
+ and be retried instead of being treated as an empty API result.
26
+ """
27
+
28
+
29
+ class FMPAPIError(FMPError):
30
+ """Raised when FMP answered with an error.
31
+
32
+ Parent of the status-bearing errors (:class:`RateLimitError`,
33
+ :class:`AuthenticationError`, :class:`ValidationError`,
34
+ :class:`FMPNotFound`) and of generic HTTP or 2xx error-body failures.
35
+ Transport failures are not :class:`FMPAPIError`.
36
+ """
37
+
38
+
39
+ class FMPTimeoutError(FMPTransportError):
21
40
  """Raised when an FMP HTTP request times out."""
22
41
 
23
42
 
24
- class FMPNetworkError(FMPError):
43
+ class FMPNetworkError(FMPTransportError):
25
44
  """Raised when an FMP HTTP request fails at the transport layer.
26
45
 
27
46
  Covers ``httpx.NetworkError`` and leftover ``httpx.RequestError``
@@ -43,7 +62,7 @@ class FMPNetworkError(FMPError):
43
62
  self.retryable = retryable
44
63
 
45
64
 
46
- class RateLimitError(FMPError):
65
+ class RateLimitError(FMPAPIError):
47
66
  """Raised when API rate limit is exceeded"""
48
67
 
49
68
  def __init__(
@@ -63,13 +82,13 @@ class RateLimitError(FMPError):
63
82
  return base_msg
64
83
 
65
84
 
66
- class AuthenticationError(FMPError):
85
+ class AuthenticationError(FMPAPIError):
67
86
  """Raised when API key is invalid or missing"""
68
87
 
69
88
  pass
70
89
 
71
90
 
72
- class ValidationError(FMPError):
91
+ class ValidationError(FMPAPIError):
73
92
  """Raised when request parameters are invalid"""
74
93
 
75
94
  pass
@@ -116,7 +135,7 @@ class DependencyError(ConfigError):
116
135
  self.install_command = install_command
117
136
 
118
137
 
119
- class FMPNotFound(FMPError):
138
+ class FMPNotFound(FMPAPIError):
120
139
  """Raised when a requested symbol or resource cannot be found."""
121
140
 
122
141
  def __init__(self, symbol: str):
@@ -114,7 +114,12 @@ class FundamentalClient(EndpointGroup):
114
114
  def get_owner_earnings(
115
115
  self, symbol: str, limit: int | None = None
116
116
  ) -> list[OwnerEarnings]:
117
- """Get owner earnings metrics"""
117
+ """Get owner earnings metrics.
118
+
119
+ Includes companies with no fixed assets and semi-annual reporters.
120
+ Semi-annual growth compares each period with the same period a year
121
+ earlier.
122
+ """
118
123
  return self._unwrap_list(
119
124
  self.client.request(endpoints.OWNER_EARNINGS, symbol=symbol, limit=limit),
120
125
  OwnerEarnings,
@@ -39,7 +39,14 @@ class HistoricalIndexConstituent(BaseModel):
39
39
 
40
40
  model_config = default_model_config
41
41
 
42
- date: datetime = Field(description="Date of change")
42
+ date: datetime = Field(
43
+ description="Calendar date of the index change, as reported by FMP"
44
+ )
45
+ change_type: str | None = Field(
46
+ None,
47
+ alias="changeType",
48
+ description="Kind of change: addition, removal, or replacement",
49
+ )
43
50
  symbol: str | None = Field(None, description="Stock symbol")
44
51
  date_added: str | None = Field(
45
52
  None, alias="dateAdded", description="Human-readable date added"
@@ -5,7 +5,9 @@ from datetime import date
5
5
  from typing import Any
6
6
 
7
7
  from fmp_data.base import AsyncEndpointGroup
8
+ from fmp_data.exceptions import ValidationError
8
9
  from fmp_data.helpers import RemovedEndpointError, deprecated, removed
10
+ from fmp_data.intelligence.client import MarketIntelligenceClient
9
11
  from fmp_data.intelligence.endpoints import (
10
12
  CROWDFUNDING_BY_CIK,
11
13
  CROWDFUNDING_RSS,
@@ -52,6 +54,13 @@ from fmp_data.intelligence.endpoints import (
52
54
  STOCK_NEWS_ENDPOINT,
53
55
  STOCK_SPLITS_CALENDAR,
54
56
  STOCK_SYMBOL_NEWS_ENDPOINT,
57
+ TIPRANKS_ANALYST_SUMMARY,
58
+ TIPRANKS_ANALYSTS,
59
+ TIPRANKS_FIRM_SUMMARY,
60
+ TIPRANKS_PIT_ANALYST,
61
+ TIPRANKS_PIT_SYMBOL,
62
+ TIPRANKS_SEARCH,
63
+ TIPRANKS_SYMBOL_SUMMARY,
55
64
  )
56
65
  from fmp_data.intelligence.models import (
57
66
  CrowdfundingOffering,
@@ -91,6 +100,10 @@ from fmp_data.intelligence.models import (
91
100
  StockNewsArticle,
92
101
  StockNewsSentiment,
93
102
  StockSplitEvent,
103
+ TipRanksAnalyst,
104
+ TipRanksPointInTimeRating,
105
+ TipRanksRating,
106
+ TipRanksSummary,
94
107
  TrendingSocialSentiment,
95
108
  )
96
109
 
@@ -1003,3 +1016,179 @@ class AsyncMarketIntelligenceClient(AsyncEndpointGroup):
1003
1016
  await self.client.request_async(GRADES_LATEST_NEWS, page=page),
1004
1017
  StockGradeNews,
1005
1018
  )
1019
+
1020
+ async def search_tipranks_ratings(
1021
+ self,
1022
+ symbol: str | None = None,
1023
+ *,
1024
+ expert_uid: str | None = None,
1025
+ firm_name: str | None = None,
1026
+ start_date: date | None = None,
1027
+ end_date: date | None = None,
1028
+ limit: int | None = None,
1029
+ page: int | None = None,
1030
+ nonadjusted: bool | None = None,
1031
+ ) -> list[TipRanksRating]:
1032
+ """Search TipRanks analyst ratings.
1033
+
1034
+ History covers about three years. Unset filters, including
1035
+ ``firm_name``, are omitted. ``firm_name`` must match the published
1036
+ firm exactly.
1037
+ """
1038
+ params = MarketIntelligenceClient._omit_unset(
1039
+ {
1040
+ "symbol": symbol,
1041
+ "expert_uid": expert_uid,
1042
+ "firm_name": firm_name,
1043
+ "start_date": MarketIntelligenceClient._format_date(start_date),
1044
+ "end_date": MarketIntelligenceClient._format_date(end_date),
1045
+ "limit": limit,
1046
+ "page": page,
1047
+ "nonadjusted": nonadjusted,
1048
+ }
1049
+ )
1050
+ return self._unwrap_list(
1051
+ await self.client.request_async(TIPRANKS_SEARCH, **params),
1052
+ TipRanksRating,
1053
+ )
1054
+
1055
+ async def get_tipranks_pit_by_symbol(
1056
+ self,
1057
+ symbol: str,
1058
+ *,
1059
+ as_of: date | None = None,
1060
+ limit: int | None = None,
1061
+ page: int | None = None,
1062
+ nonadjusted: bool | None = None,
1063
+ ) -> list[TipRanksPointInTimeRating]:
1064
+ """Get each analyst's latest TipRanks call on a symbol as of a date.
1065
+
1066
+ History covers about three years.
1067
+ """
1068
+ params = MarketIntelligenceClient._omit_unset(
1069
+ {
1070
+ "as_of": MarketIntelligenceClient._format_date(as_of),
1071
+ "limit": limit,
1072
+ "page": page,
1073
+ "nonadjusted": nonadjusted,
1074
+ }
1075
+ )
1076
+ return self._unwrap_list(
1077
+ await self.client.request_async(
1078
+ TIPRANKS_PIT_SYMBOL, symbol=symbol, **params
1079
+ ),
1080
+ TipRanksPointInTimeRating,
1081
+ )
1082
+
1083
+ async def get_tipranks_pit_by_analyst(
1084
+ self,
1085
+ *,
1086
+ expert_uid: str | None = None,
1087
+ analyst_name: str | None = None,
1088
+ as_of: date | None = None,
1089
+ limit: int | None = None,
1090
+ page: int | None = None,
1091
+ nonadjusted: bool | None = None,
1092
+ ) -> list[TipRanksPointInTimeRating]:
1093
+ """Get one analyst's TipRanks book as of a date.
1094
+
1095
+ Pass ``expert_uid`` or the exact published ``analyst_name``.
1096
+ """
1097
+ if expert_uid is None and analyst_name is None:
1098
+ raise ValidationError("expert_uid or analyst_name is required")
1099
+ params = MarketIntelligenceClient._omit_unset(
1100
+ {
1101
+ "expert_uid": expert_uid,
1102
+ "analyst_name": analyst_name,
1103
+ "as_of": MarketIntelligenceClient._format_date(as_of),
1104
+ "limit": limit,
1105
+ "page": page,
1106
+ "nonadjusted": nonadjusted,
1107
+ }
1108
+ )
1109
+ return self._unwrap_list(
1110
+ await self.client.request_async(TIPRANKS_PIT_ANALYST, **params),
1111
+ TipRanksPointInTimeRating,
1112
+ )
1113
+
1114
+ async def get_tipranks_symbol_summary(
1115
+ self,
1116
+ symbol: str,
1117
+ *,
1118
+ start_date: date | None = None,
1119
+ end_date: date | None = None,
1120
+ ) -> TipRanksSummary | None:
1121
+ """Get the TipRanks ratings rollup for a symbol."""
1122
+ params = MarketIntelligenceClient._omit_unset(
1123
+ {
1124
+ "start_date": MarketIntelligenceClient._format_date(start_date),
1125
+ "end_date": MarketIntelligenceClient._format_date(end_date),
1126
+ }
1127
+ )
1128
+ result = await self.client.request_async(
1129
+ TIPRANKS_SYMBOL_SUMMARY, symbol=symbol, **params
1130
+ )
1131
+ return self._unwrap_single(result, TipRanksSummary, allow_none=True)
1132
+
1133
+ async def get_tipranks_analyst_summary(
1134
+ self,
1135
+ expert_uid: str,
1136
+ *,
1137
+ start_date: date | None = None,
1138
+ end_date: date | None = None,
1139
+ ) -> TipRanksSummary | None:
1140
+ """Get the TipRanks ratings rollup for one analyst."""
1141
+ params = MarketIntelligenceClient._omit_unset(
1142
+ {
1143
+ "start_date": MarketIntelligenceClient._format_date(start_date),
1144
+ "end_date": MarketIntelligenceClient._format_date(end_date),
1145
+ }
1146
+ )
1147
+ result = await self.client.request_async(
1148
+ TIPRANKS_ANALYST_SUMMARY, expert_uid=expert_uid, **params
1149
+ )
1150
+ return self._unwrap_single(result, TipRanksSummary, allow_none=True)
1151
+
1152
+ async def get_tipranks_firm_summary(
1153
+ self,
1154
+ firm_name: str,
1155
+ *,
1156
+ start_date: date | None = None,
1157
+ end_date: date | None = None,
1158
+ ) -> TipRanksSummary | None:
1159
+ """Get the TipRanks ratings rollup for one firm."""
1160
+ params = MarketIntelligenceClient._omit_unset(
1161
+ {
1162
+ "start_date": MarketIntelligenceClient._format_date(start_date),
1163
+ "end_date": MarketIntelligenceClient._format_date(end_date),
1164
+ }
1165
+ )
1166
+ result = await self.client.request_async(
1167
+ TIPRANKS_FIRM_SUMMARY, firm_name=firm_name, **params
1168
+ )
1169
+ return self._unwrap_single(result, TipRanksSummary, allow_none=True)
1170
+
1171
+ async def get_tipranks_analysts(
1172
+ self,
1173
+ *,
1174
+ analyst_name: str | None = None,
1175
+ firm_name: str | None = None,
1176
+ limit: int | None = None,
1177
+ page: int | None = None,
1178
+ ) -> list[TipRanksAnalyst]:
1179
+ """Look up TipRanks analysts.
1180
+
1181
+ ``analyst_name`` is an exact published name, not a fuzzy search.
1182
+ """
1183
+ params = MarketIntelligenceClient._omit_unset(
1184
+ {
1185
+ "analyst_name": analyst_name,
1186
+ "firm_name": firm_name,
1187
+ "limit": limit,
1188
+ "page": page,
1189
+ }
1190
+ )
1191
+ return self._unwrap_list(
1192
+ await self.client.request_async(TIPRANKS_ANALYSTS, **params),
1193
+ TipRanksAnalyst,
1194
+ )