fmp-data 2.4.0__tar.gz → 2.6.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 (238) hide show
  1. {fmp_data-2.4.0 → fmp_data-2.6.0}/.gitignore +3 -0
  2. {fmp_data-2.4.0 → fmp_data-2.6.0}/PKG-INFO +104 -75
  3. {fmp_data-2.4.0 → fmp_data-2.6.0}/README.md +90 -61
  4. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/__init__.py +2 -0
  5. fmp_data-2.6.0/fmp_data/_version.py +24 -0
  6. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/alternative/async_client.py +51 -9
  7. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/alternative/client.py +51 -9
  8. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/alternative/endpoints.py +13 -60
  9. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/alternative/mapping.py +28 -31
  10. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/alternative/models.py +4 -3
  11. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/alternative/schema.py +15 -5
  12. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/batch/endpoints.py +0 -29
  13. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/batch/mapping.py +50 -23
  14. fmp_data-2.6.0/fmp_data/cache/config.py +149 -0
  15. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/company/async_client.py +107 -23
  16. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/company/client.py +107 -21
  17. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/company/endpoints.py +49 -165
  18. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/company/hints.py +5 -18
  19. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/company/mapping.py +92 -17
  20. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/company/models.py +12 -11
  21. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/economics/endpoints.py +1 -26
  22. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/economics/mapping.py +1 -21
  23. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/economics/models.py +4 -3
  24. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/exceptions.py +51 -0
  25. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/fundamental/async_client.py +20 -4
  26. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/fundamental/client.py +20 -2
  27. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/fundamental/endpoints.py +4 -52
  28. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/fundamental/mapping.py +23 -78
  29. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/fundamental/models.py +4 -2
  30. fmp_data-2.6.0/fmp_data/helpers.py +229 -0
  31. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/index/models.py +3 -1
  32. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/institutional/async_client.py +206 -53
  33. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/institutional/client.py +242 -49
  34. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/institutional/endpoints.py +34 -91
  35. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/institutional/mapping.py +53 -125
  36. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/institutional/models.py +37 -26
  37. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/institutional/schema.py +3 -2
  38. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/intelligence/async_client.py +100 -25
  39. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/intelligence/client.py +100 -25
  40. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/intelligence/endpoints.py +38 -102
  41. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/intelligence/mapping.py +464 -152
  42. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/intelligence/models.py +71 -22
  43. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/investment/async_client.py +98 -24
  44. fmp_data-2.6.0/fmp_data/investment/client.py +233 -0
  45. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/investment/endpoints.py +43 -28
  46. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/investment/mapping.py +53 -47
  47. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/investment/models.py +6 -4
  48. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/investment/schema.py +19 -5
  49. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/lc/__init__.py +131 -36
  50. fmp_data-2.6.0/fmp_data/lc/hints.py +503 -0
  51. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/lc/models.py +25 -0
  52. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/lc/registry.py +290 -80
  53. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/lc/vector_store.py +413 -64
  54. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/market/async_client.py +54 -12
  55. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/market/client.py +54 -12
  56. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/market/endpoints.py +25 -90
  57. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/market/mapping.py +31 -12
  58. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/market/models.py +7 -5
  59. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/market/schema.py +26 -9
  60. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/mcp/__main__.py +3 -3
  61. fmp_data-2.6.0/fmp_data/mcp/_compat.py +49 -0
  62. fmp_data-2.6.0/fmp_data/mcp/cli.py +1270 -0
  63. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/mcp/discovery.py +10 -1
  64. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/mcp/server.py +8 -12
  65. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/mcp/setup.py +3 -4
  66. fmp_data-2.6.0/fmp_data/mcp/tool_loader.py +468 -0
  67. fmp_data-2.6.0/fmp_data/mcp/tools_manifest.py +297 -0
  68. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/models.py +242 -10
  69. fmp_data-2.6.0/fmp_data/schema.py +278 -0
  70. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/sec/async_client.py +6 -4
  71. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/sec/client.py +4 -4
  72. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/sec/endpoints.py +17 -44
  73. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/sec/mapping.py +80 -11
  74. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/sec/models.py +8 -6
  75. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/technical/endpoints.py +0 -55
  76. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/technical/mapping.py +11 -44
  77. fmp_data-2.6.0/fmp_data/tool_binding.py +352 -0
  78. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/transcripts/endpoints.py +0 -7
  79. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/transcripts/mapping.py +14 -3
  80. {fmp_data-2.4.0 → fmp_data-2.6.0}/pyproject.toml +59 -26
  81. fmp_data-2.6.0/tests/e2e/test_live_signatures.py +619 -0
  82. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/examples/test_examples_smoke.py +9 -7
  83. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/conftest.py +1 -1
  84. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_economics.py +12 -12
  85. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_intelligence.py +74 -49
  86. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_investment.py +8 -1
  87. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_lc.py +25 -18
  88. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_market.py +9 -9
  89. fmp_data-2.6.0/tests/unit/lc/__init__.py +0 -0
  90. fmp_data-2.6.0/tests/unit/lc/test_deprecated_endpoints.py +296 -0
  91. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/lc/test_endpoint_based_rules.py +0 -2
  92. fmp_data-2.6.0/tests/unit/lc/test_endpoint_method_coverage.py +314 -0
  93. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/lc/test_mapping.py +34 -20
  94. fmp_data-2.6.0/tests/unit/lc/test_method_dispatch.py +654 -0
  95. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/lc/test_models.py +2 -2
  96. fmp_data-2.6.0/tests/unit/lc/test_tool_schema.py +302 -0
  97. fmp_data-2.6.0/tests/unit/lc/test_validation_registry.py +362 -0
  98. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/lc/test_vector_store.py +30 -13
  99. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_alternative.py +6 -6
  100. fmp_data-2.6.0/tests/unit/test_arg_model_deprecation.py +402 -0
  101. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_async_clients.py +517 -78
  102. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_base.py +6 -4
  103. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_base_async.py +12 -6
  104. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_base_coverage.py +1 -0
  105. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_cache_backends.py +2 -2
  106. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_cache_integration.py +3 -3
  107. fmp_data-2.6.0/tests/unit/test_cache_ttl_override_keys.py +166 -0
  108. fmp_data-2.6.0/tests/unit/test_catalog_registration.py +517 -0
  109. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_client.py +6 -3
  110. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_company.py +16 -10
  111. fmp_data-2.6.0/tests/unit/test_datetime_shadowing.py +121 -0
  112. fmp_data-2.6.0/tests/unit/test_deprecated_endpoint_flags.py +148 -0
  113. fmp_data-2.6.0/tests/unit/test_deprecated_methods_warn.py +287 -0
  114. fmp_data-2.6.0/tests/unit/test_docs_endpoints_sync.py +301 -0
  115. fmp_data-2.6.0/tests/unit/test_docs_tools_sync.py +149 -0
  116. fmp_data-2.6.0/tests/unit/test_endpoint_registry.py +131 -0
  117. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_exceptions.py +1 -0
  118. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_fundamental.py +1 -0
  119. fmp_data-2.6.0/tests/unit/test_helpers.py +537 -0
  120. fmp_data-2.6.0/tests/unit/test_hint_consolidation.py +537 -0
  121. fmp_data-2.6.0/tests/unit/test_imports.py +110 -0
  122. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_institutional.py +433 -0
  123. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_intelligence.py +174 -56
  124. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_investment.py +87 -16
  125. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_logger.py +5 -1
  126. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_market.py +13 -11
  127. fmp_data-2.6.0/tests/unit/test_mcp.py +1614 -0
  128. fmp_data-2.6.0/tests/unit/test_mcp_cli.py +1103 -0
  129. fmp_data-2.6.0/tests/unit/test_mcp_entry_point_coherence.py +774 -0
  130. fmp_data-2.6.0/tests/unit/test_models.py +570 -0
  131. fmp_data-2.6.0/tests/unit/test_param_required_consistency.py +413 -0
  132. fmp_data-2.6.0/tests/unit/test_tool_binding.py +435 -0
  133. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_vcr_sanitization.py +3 -4
  134. fmp_data-2.6.0/tests/unit/test_vector_store_error_contract.py +191 -0
  135. fmp_data-2.4.0/fmp_data/cache/config.py +0 -58
  136. fmp_data-2.4.0/fmp_data/helpers.py +0 -80
  137. fmp_data-2.4.0/fmp_data/investment/client.py +0 -157
  138. fmp_data-2.4.0/fmp_data/lc/hints.py +0 -66
  139. fmp_data-2.4.0/fmp_data/mcp/cli.py +0 -485
  140. fmp_data-2.4.0/fmp_data/mcp/tool_loader.py +0 -149
  141. fmp_data-2.4.0/fmp_data/mcp/tools_manifest.py +0 -205
  142. fmp_data-2.4.0/fmp_data/schema.py +0 -165
  143. fmp_data-2.4.0/tests/unit/lc/test_validation_registry.py +0 -139
  144. fmp_data-2.4.0/tests/unit/test_helpers.py +0 -117
  145. fmp_data-2.4.0/tests/unit/test_mcp.py +0 -431
  146. fmp_data-2.4.0/tests/unit/test_mcp_cli.py +0 -489
  147. fmp_data-2.4.0/tests/unit/test_models.py +0 -239
  148. {fmp_data-2.4.0 → fmp_data-2.6.0}/LICENSE +0 -0
  149. {fmp_data-2.4.0 → fmp_data-2.6.0}/NOTICE +0 -0
  150. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/alternative/__init__.py +0 -0
  151. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/async_client.py +0 -0
  152. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/base.py +0 -0
  153. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/batch/__init__.py +0 -0
  154. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/batch/_csv_utils.py +0 -0
  155. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/batch/async_client.py +0 -0
  156. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/batch/client.py +0 -0
  157. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/batch/models.py +0 -0
  158. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/cache/__init__.py +0 -0
  159. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/cache/base.py +0 -0
  160. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/cache/file.py +0 -0
  161. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/cache/memory.py +0 -0
  162. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/cache/redis_backend.py +0 -0
  163. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/client.py +0 -0
  164. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/company/__init__.py +0 -0
  165. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/company/schema.py +0 -0
  166. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/config.py +0 -0
  167. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/economics/__init__.py +0 -0
  168. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/economics/async_client.py +0 -0
  169. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/economics/client.py +0 -0
  170. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/economics/schema.py +0 -0
  171. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/fundamental/__init__.py +0 -0
  172. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/fundamental/schema.py +0 -0
  173. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/index/__init__.py +0 -0
  174. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/index/async_client.py +0 -0
  175. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/index/client.py +0 -0
  176. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/index/endpoints.py +0 -0
  177. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/index/mapping.py +0 -0
  178. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/institutional/__init__.py +0 -0
  179. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/intelligence/__init__.py +0 -0
  180. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/intelligence/schema.py +0 -0
  181. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/investment/__init__.py +0 -0
  182. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/lc/config.py +0 -0
  183. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/lc/embedding.py +0 -0
  184. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/lc/mapping.py +0 -0
  185. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/lc/utils.py +0 -0
  186. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/lc/validation.py +0 -0
  187. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/logger.py +0 -0
  188. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/market/__init__.py +0 -0
  189. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/market/hints.py +0 -0
  190. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/mcp/__init__.py +0 -0
  191. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/mcp/utils.py +0 -0
  192. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/py.typed +0 -0
  193. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/rate_limit.py +0 -0
  194. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/sec/__init__.py +0 -0
  195. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/technical/__init__.py +0 -0
  196. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/technical/async_client.py +0 -0
  197. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/technical/client.py +0 -0
  198. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/technical/models.py +0 -0
  199. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/technical/schema.py +0 -0
  200. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/transcripts/__init__.py +0 -0
  201. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/transcripts/async_client.py +0 -0
  202. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/transcripts/client.py +0 -0
  203. {fmp_data-2.4.0 → fmp_data-2.6.0}/fmp_data/transcripts/models.py +0 -0
  204. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/__init__.py +0 -0
  205. {fmp_data-2.4.0/tests/integration → fmp_data-2.6.0/tests/e2e}/__init__.py +0 -0
  206. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/examples/__init__.py +0 -0
  207. {fmp_data-2.4.0/tests/unit → fmp_data-2.6.0/tests/integration}/__init__.py +0 -0
  208. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/base.py +0 -0
  209. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_alternative.py +0 -0
  210. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_batch.py +0 -0
  211. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_company.py +0 -0
  212. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_fundamental.py +0 -0
  213. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_index.py +0 -0
  214. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_institutional.py +0 -0
  215. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_sec.py +0 -0
  216. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_technical.py +0 -0
  217. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/integration/test_transcripts.py +0 -0
  218. {fmp_data-2.4.0/tests/unit/lc → fmp_data-2.6.0/tests/unit}/__init__.py +0 -0
  219. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/conftest.py +0 -0
  220. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/lc/conftest.py +0 -0
  221. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/lc/test_config.py +0 -0
  222. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/lc/test_embedding.py +0 -0
  223. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/lc/test_imports.py +0 -0
  224. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/lc/test_utils.py +0 -0
  225. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_alternative_coverage.py +0 -0
  226. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_batch.py +0 -0
  227. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_cassette_contracts.py +0 -0
  228. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_company_coverage.py +0 -0
  229. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_config.py +0 -0
  230. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_economics.py +0 -0
  231. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_index.py +0 -0
  232. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_rate_limit.py +0 -0
  233. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_rate_limit_async.py +0 -0
  234. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_rate_limit_coverage.py +0 -0
  235. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_sec.py +0 -0
  236. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_technical.py +0 -0
  237. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_technical_coverage.py +0 -0
  238. {fmp_data-2.4.0 → fmp_data-2.6.0}/tests/unit/test_transcripts.py +0 -0
@@ -83,3 +83,6 @@ reports/
83
83
 
84
84
  # Firecrawl example outputs
85
85
  examples/firecrawl_app/outputs/
86
+
87
+ # Generated at build time by hatch-vcs (see [tool.hatch.build.hooks.vcs])
88
+ fmp_data/_version.py
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: fmp-data
3
- Version: 2.4.0
3
+ Version: 2.6.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
@@ -31,15 +31,15 @@ Requires-Dist: httpx>=0.28.1
31
31
  Requires-Dist: pydantic>=2.13.4
32
32
  Requires-Dist: tenacity>=9.1.4
33
33
  Provides-Extra: cache-redis
34
- Requires-Dist: redis>=8.0.1; extra == 'cache-redis'
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.15.1; extra == 'dev'
37
+ Requires-Dist: coverage>=7.15.4; extra == 'dev'
38
38
  Requires-Dist: freezegun>=1.5.5; extra == 'dev'
39
- Requires-Dist: mypy>=2.2.0; extra == 'dev'
39
+ Requires-Dist: mypy>=2.3.0; extra == 'dev'
40
40
  Requires-Dist: nox>=2026.7.11; extra == 'dev'
41
41
  Requires-Dist: pip-audit>=2.10.1; extra == 'dev'
42
- Requires-Dist: pre-commit>=4.6.0; extra == 'dev'
42
+ Requires-Dist: pre-commit>=4.6.1; extra == 'dev'
43
43
  Requires-Dist: pytest-asyncio>=1.4.0; extra == 'dev'
44
44
  Requires-Dist: pytest-cov>=7.1.0; extra == 'dev'
45
45
  Requires-Dist: pytest-mock>=3.15.1; extra == 'dev'
@@ -48,23 +48,23 @@ Requires-Dist: pytest>=9.1.1; extra == 'dev'
48
48
  Requires-Dist: python-dotenv>=1.2.2; extra == 'dev'
49
49
  Requires-Dist: responses>=0.26.2; extra == 'dev'
50
50
  Requires-Dist: rich>=15.0.0; extra == 'dev'
51
- Requires-Dist: ruff>=0.15.21; extra == 'dev'
52
- Requires-Dist: twine>=6.2.0; extra == 'dev'
51
+ Requires-Dist: ruff>=0.16.2; extra == 'dev'
52
+ Requires-Dist: twine>=7.0.0; extra == 'dev'
53
53
  Requires-Dist: vcrpy>=8.3.0; extra == 'dev'
54
54
  Provides-Extra: docs
55
- Requires-Dist: mkdocs-material>=9.7.6; extra == 'docs'
55
+ Requires-Dist: mkdocs-material>=9.7.7; extra == 'docs'
56
56
  Requires-Dist: mkdocs>=1.6.1; extra == 'docs'
57
57
  Requires-Dist: mkdocstrings-python>=2.0.5; extra == 'docs'
58
58
  Provides-Extra: langchain
59
- Requires-Dist: faiss-cpu>=1.14.3; extra == 'langchain'
59
+ Requires-Dist: faiss-cpu>=1.15.0; extra == 'langchain'
60
60
  Requires-Dist: langchain-community>=0.4.2; extra == 'langchain'
61
- Requires-Dist: langchain-core>=1.4.9; extra == 'langchain'
62
- Requires-Dist: langchain-openai>=1.3.5; extra == 'langchain'
63
- Requires-Dist: langgraph>=1.2.9; extra == 'langchain'
64
- Requires-Dist: openai>=2.45.0; extra == 'langchain'
61
+ Requires-Dist: langchain-core>=1.5.3; extra == 'langchain'
62
+ Requires-Dist: langchain-openai>=1.4.2; extra == 'langchain'
63
+ Requires-Dist: langgraph>=1.2.10; extra == 'langchain'
64
+ Requires-Dist: openai>=2.53.0; extra == 'langchain'
65
65
  Requires-Dist: tiktoken>=0.13.0; extra == 'langchain'
66
66
  Provides-Extra: mcp
67
- Requires-Dist: mcp[cli]>=1.28.1; extra == 'mcp'
67
+ Requires-Dist: mcp[cli]>=2.0.0; extra == 'mcp'
68
68
  Requires-Dist: pyyaml>=6.0.3; extra == 'mcp'
69
69
  Description-Content-Type: text/markdown
70
70
 
@@ -172,7 +172,7 @@ config = ClientConfig(
172
172
  cache=CacheConfig(
173
173
  backend="memory",
174
174
  default_ttl=300,
175
- ttl_overrides={"get_quote": 30},
175
+ ttl_overrides={"quote": 30},
176
176
  ),
177
177
  )
178
178
 
@@ -293,19 +293,25 @@ For the full MCP catalog, run `fmp-mcp list` or see [docs/mcp/tools.md](https://
293
293
  ### Quick Start with Vector Store
294
294
 
295
295
  ```python
296
- from fmp_data import create_vector_store
296
+ from fmp_data import VectorStoreCreationError, create_vector_store
297
297
 
298
- # Initialize the vector store
299
- vector_store = create_vector_store(
300
- fmp_api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
301
- openai_api_key="YOUR_OPENAI_API_KEY" # pragma: allowlist secret
302
- )
298
+ # Initialize the vector store. Raises VectorStoreCreationError if it cannot be
299
+ # built; the exception carries the underlying `cause` and a `failures` dict of
300
+ # any endpoints skipped during registration.
301
+ try:
302
+ vector_store = create_vector_store(
303
+ fmp_api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
304
+ openai_api_key="YOUR_OPENAI_API_KEY", # pragma: allowlist secret
305
+ )
306
+ except VectorStoreCreationError as exc:
307
+ print(f"Could not build the vector store: {exc.cause}")
308
+ raise
303
309
 
304
310
  # Example queries
305
311
  queries = [
306
312
  "what is the price of Apple stock?",
307
313
  "what was the revenue of Tesla last year?",
308
- "what's new in the market?"
314
+ "what's new in the market?",
309
315
  ]
310
316
 
311
317
  # Search for relevant endpoints and tools
@@ -319,7 +325,7 @@ for query in queries:
319
325
  for tool in tools:
320
326
  print(f"Name: {tool.get('name')}")
321
327
  print(f"Description: {tool.get('description')}")
322
- print("Parameters:", tool.get('parameters'))
328
+ print("Parameters:", tool.get("parameters"))
323
329
  print()
324
330
 
325
331
  # You can also search endpoints directly
@@ -346,10 +352,10 @@ from fmp_data.lc.embedding import EmbeddingProvider
346
352
 
347
353
  # Configure with LangChain support
348
354
  config = LangChainConfig(
349
- api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
355
+ api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
350
356
  embedding_provider=EmbeddingProvider.OPENAI,
351
- embedding_api_key="YOUR_OPENAI_API_KEY", # pragma: allowlist secret
352
- embedding_model="text-embedding-3-small"
357
+ embedding_api_key="YOUR_OPENAI_API_KEY", # pragma: allowlist secret
358
+ embedding_model="text-embedding-3-small",
353
359
  )
354
360
 
355
361
  # Create client with LangChain config
@@ -362,7 +368,7 @@ vector_store = create_vector_store(
362
368
  cache_dir=config.vector_store_path,
363
369
  embedding_provider=config.embedding_provider,
364
370
  embedding_model=config.embedding_model,
365
- )
371
+ ) # raises VectorStoreCreationError on failure -- see the example above
366
372
 
367
373
  # Search for relevant endpoints
368
374
  results = vector_store.search("show me Tesla's financial metrics")
@@ -391,6 +397,42 @@ export FMP_EMBEDDING_MODEL=text-embedding-3-small
391
397
  - Automatic caching of embeddings
392
398
  - Persistent vector store for faster lookups
393
399
 
400
+ ### Tool argument names (LangChain vs MCP)
401
+
402
+ LangChain tools built from the vector store keep **API / wire** parameter names
403
+ (`from`, `to`, `periodLength`, `sicCode`, …). When the method shape is
404
+ compatible, those names are mapped onto the matching client method
405
+ (`from_date` / `start_date`, …) at invoke so method defaults and constraints
406
+ still apply (#172 / #186). If a required method parameter had no wire source,
407
+ LangChain would keep the wire schema and fall back to `client.request` instead
408
+ of the method — as of #188 no tool in the catalog does, so every LangChain tool
409
+ dispatches through a client method.
410
+
411
+ MCP tools expose the **Python method** parameter names instead (the signature
412
+ of `client.<module>.<method>`). The same endpoint can therefore show
413
+ `from`/`to` in a LangChain schema and `from_date`/`to_date` (or
414
+ `start_date`/`end_date`) on MCP — both are intentional.
415
+
416
+ The institutional Form 13F and symbol-positions-summary tools used to be the
417
+ exception, because their client methods required a `report_date` the wire does
418
+ not have. They now dispatch through `get_form_13f_by_quarter` and
419
+ `get_institutional_holdings_by_quarter`, whose `year`/`quarter` arguments match
420
+ the API (which rejects a request without them). The date-shaped
421
+ `get_form_13f(cik, report_date)` and
422
+ `get_institutional_holdings(symbol, report_date)` are unchanged and remain the
423
+ convenient Python entry points.
424
+
425
+ Both integrations resolve and bind through one module, `fmp_data.tool_binding`
426
+ — attribute-chain resolution, the wire→method name aliases, the
427
+ required-parameter coverage gate, and the invoke-time kwargs mapping. It lives
428
+ in the core package (no LangChain or MCP import), so the rules cannot drift
429
+ apart between the two (#188).
430
+
431
+ A catalogue-wide guard (`tests/unit/lc/test_endpoint_method_coverage.py`) fails
432
+ CI on *new* uncovered required method parameters or newly dropped mandatory
433
+ wire fields under method dispatch. Known cases are allowlisted in that test
434
+ (#188).
435
+
394
436
  ## Quick Start
395
437
 
396
438
  ```python
@@ -398,23 +440,23 @@ from fmp_data import FMPDataClient, ClientConfig, LoggingConfig
398
440
  from fmp_data.exceptions import FMPError, RateLimitError, AuthenticationError
399
441
 
400
442
  # Method 1: Initialize with direct API key
401
- client = FMPDataClient(api_key="your_api_key_here") # pragma: allowlist secret
443
+ client = FMPDataClient(api_key="your_api_key_here") # pragma: allowlist secret
402
444
 
403
445
  # Method 2: Initialize from environment variable (FMP_API_KEY)
404
446
  client = FMPDataClient.from_env()
405
447
 
406
448
  # Method 3: Initialize with custom configuration
407
449
  config = ClientConfig(
408
- api_key="your_api_key_here", #pragma: allowlist secret
450
+ api_key="your_api_key_here", # pragma: allowlist secret
409
451
  timeout=30,
410
452
  max_retries=3,
411
453
  base_url="https://financialmodelingprep.com",
412
- logging=LoggingConfig(level="INFO")
454
+ logging=LoggingConfig(level="INFO"),
413
455
  )
414
456
  client = FMPDataClient(config=config)
415
457
 
416
458
  # Using with context manager (recommended)
417
- with FMPDataClient(api_key="your_api_key_here") as client: # pragma: allowlist secret
459
+ with FMPDataClient(api_key="your_api_key_here") as client: # pragma: allowlist secret
418
460
  try:
419
461
  # Get company profile
420
462
  profile = client.company.get_profile("AAPL")
@@ -492,14 +534,11 @@ with FMPDataClient.from_env() as client:
492
534
  income_stmt = client.fundamental.get_income_statement(
493
535
  "AAPL",
494
536
  period="quarter", # or "annual"
495
- limit=4
537
+ limit=4,
496
538
  )
497
539
 
498
540
  # Get balance sheets
499
- balance_sheet = client.fundamental.get_balance_sheet(
500
- "AAPL",
501
- period="annual"
502
- )
541
+ balance_sheet = client.fundamental.get_balance_sheet("AAPL", period="annual")
503
542
 
504
543
  # Get cash flow statements
505
544
  cash_flow = client.fundamental.get_cash_flow("AAPL")
@@ -515,16 +554,11 @@ with FMPDataClient.from_env() as client:
515
554
 
516
555
  # Get historical prices
517
556
  history = client.company.get_historical_prices(
518
- symbol="TSLA",
519
- from_date=date(2023, 1, 1),
520
- to_date=date(2023, 12, 31)
557
+ symbol="TSLA", from_date=date(2023, 1, 1), to_date=date(2023, 12, 31)
521
558
  )
522
559
 
523
560
  # Get intraday prices
524
- intraday = client.company.get_intraday_prices(
525
- "TSLA",
526
- interval="5min"
527
- )
561
+ intraday = client.company.get_intraday_prices("TSLA", interval="5min")
528
562
  ```
529
563
 
530
564
  ### 4. Technical Indicators
@@ -534,25 +568,14 @@ from datetime import date
534
568
 
535
569
  with FMPDataClient.from_env() as client:
536
570
  # Simple Moving Average
537
- sma = client.technical.get_sma(
538
- "AAPL",
539
- period_length=20,
540
- timeframe="1day"
541
- )
571
+ sma = client.technical.get_sma("AAPL", period_length=20, timeframe="1day")
542
572
 
543
573
  # RSI (Relative Strength Index)
544
- rsi = client.technical.get_rsi(
545
- "AAPL",
546
- period_length=14,
547
- timeframe="1day"
548
- )
574
+ rsi = client.technical.get_rsi("AAPL", period_length=14, timeframe="1day")
549
575
 
550
576
  # MACD
551
577
  macd = client.technical.get_macd(
552
- "AAPL",
553
- fast_period=12,
554
- slow_period=26,
555
- signal_period=9
578
+ "AAPL", fast_period=12, slow_period=26, signal_period=9
556
579
  )
557
580
  ```
558
581
 
@@ -668,6 +691,7 @@ API reference in `docs/api/reference.md#async-client-usage`.
668
691
  from fmp_data import AsyncFMPDataClient
669
692
  import asyncio
670
693
 
694
+
671
695
  async def main():
672
696
  async with AsyncFMPDataClient.from_env() as client:
673
697
  # All endpoint methods are async
@@ -683,6 +707,7 @@ async def main():
683
707
  for p in profiles:
684
708
  print(f"{p.symbol}: {p.company_name}")
685
709
 
710
+
686
711
  asyncio.run(main())
687
712
  ```
688
713
 
@@ -715,7 +740,13 @@ FMP_MCP_MANIFEST=/path/to/custom/manifest.py
715
740
 
716
741
  ### Custom Configuration
717
742
  ```python
718
- from fmp_data import FMPDataClient, ClientConfig, LoggingConfig, RateLimitConfig, LogHandlerConfig
743
+ from fmp_data import (
744
+ FMPDataClient,
745
+ ClientConfig,
746
+ LoggingConfig,
747
+ RateLimitConfig,
748
+ LogHandlerConfig,
749
+ )
719
750
 
720
751
  config = ClientConfig(
721
752
  api_key="your_api_key_here", # pragma: allowlist secret
@@ -723,9 +754,7 @@ config = ClientConfig(
723
754
  max_retries=3,
724
755
  base_url="https://financialmodelingprep.com",
725
756
  rate_limit=RateLimitConfig(
726
- daily_limit=250,
727
- requests_per_second=10,
728
- requests_per_minute=300
757
+ daily_limit=250, requests_per_second=10, requests_per_minute=300
729
758
  ),
730
759
  logging=LoggingConfig(
731
760
  level="DEBUG",
@@ -733,7 +762,7 @@ config = ClientConfig(
733
762
  "console": LogHandlerConfig(
734
763
  class_name="StreamHandler",
735
764
  level="INFO",
736
- format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
765
+ format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
737
766
  ),
738
767
  "file": LogHandlerConfig(
739
768
  class_name="RotatingFileHandler",
@@ -742,11 +771,11 @@ config = ClientConfig(
742
771
  handler_kwargs={
743
772
  "filename": "fmp.log",
744
773
  "maxBytes": 10485760,
745
- "backupCount": 5
746
- }
747
- )
748
- }
749
- )
774
+ "backupCount": 5,
775
+ },
776
+ ),
777
+ },
778
+ ),
750
779
  )
751
780
 
752
781
  client = FMPDataClient(config=config)
@@ -759,15 +788,15 @@ The library provides a comprehensive exception hierarchy for robust error handli
759
788
  ```python
760
789
  from fmp_data import FMPDataClient
761
790
  from fmp_data.exceptions import (
762
- FMPError, # Base exception for all FMP errors
763
- RateLimitError, # API rate limit exceeded
764
- AuthenticationError, # Invalid or missing API key
765
- ValidationError, # Invalid request parameters
766
- ConfigError, # Configuration errors
767
- InvalidSymbolError, # Missing or blank required symbol
791
+ FMPError, # Base exception for all FMP errors
792
+ RateLimitError, # API rate limit exceeded
793
+ AuthenticationError, # Invalid or missing API key
794
+ ValidationError, # Invalid request parameters
795
+ ConfigError, # Configuration errors
796
+ InvalidSymbolError, # Missing or blank required symbol
768
797
  InvalidResponseTypeError, # Unexpected API response type
769
- DependencyError, # Missing optional dependency
770
- FMPNotFound, # Symbol or resource not found
798
+ DependencyError, # Missing optional dependency
799
+ FMPNotFound, # Symbol or resource not found
771
800
  )
772
801
 
773
802
  try:
@@ -102,7 +102,7 @@ config = ClientConfig(
102
102
  cache=CacheConfig(
103
103
  backend="memory",
104
104
  default_ttl=300,
105
- ttl_overrides={"get_quote": 30},
105
+ ttl_overrides={"quote": 30},
106
106
  ),
107
107
  )
108
108
 
@@ -223,19 +223,25 @@ For the full MCP catalog, run `fmp-mcp list` or see [docs/mcp/tools.md](https://
223
223
  ### Quick Start with Vector Store
224
224
 
225
225
  ```python
226
- from fmp_data import create_vector_store
226
+ from fmp_data import VectorStoreCreationError, create_vector_store
227
227
 
228
- # Initialize the vector store
229
- vector_store = create_vector_store(
230
- fmp_api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
231
- openai_api_key="YOUR_OPENAI_API_KEY" # pragma: allowlist secret
232
- )
228
+ # Initialize the vector store. Raises VectorStoreCreationError if it cannot be
229
+ # built; the exception carries the underlying `cause` and a `failures` dict of
230
+ # any endpoints skipped during registration.
231
+ try:
232
+ vector_store = create_vector_store(
233
+ fmp_api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
234
+ openai_api_key="YOUR_OPENAI_API_KEY", # pragma: allowlist secret
235
+ )
236
+ except VectorStoreCreationError as exc:
237
+ print(f"Could not build the vector store: {exc.cause}")
238
+ raise
233
239
 
234
240
  # Example queries
235
241
  queries = [
236
242
  "what is the price of Apple stock?",
237
243
  "what was the revenue of Tesla last year?",
238
- "what's new in the market?"
244
+ "what's new in the market?",
239
245
  ]
240
246
 
241
247
  # Search for relevant endpoints and tools
@@ -249,7 +255,7 @@ for query in queries:
249
255
  for tool in tools:
250
256
  print(f"Name: {tool.get('name')}")
251
257
  print(f"Description: {tool.get('description')}")
252
- print("Parameters:", tool.get('parameters'))
258
+ print("Parameters:", tool.get("parameters"))
253
259
  print()
254
260
 
255
261
  # You can also search endpoints directly
@@ -276,10 +282,10 @@ from fmp_data.lc.embedding import EmbeddingProvider
276
282
 
277
283
  # Configure with LangChain support
278
284
  config = LangChainConfig(
279
- api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
285
+ api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
280
286
  embedding_provider=EmbeddingProvider.OPENAI,
281
- embedding_api_key="YOUR_OPENAI_API_KEY", # pragma: allowlist secret
282
- embedding_model="text-embedding-3-small"
287
+ embedding_api_key="YOUR_OPENAI_API_KEY", # pragma: allowlist secret
288
+ embedding_model="text-embedding-3-small",
283
289
  )
284
290
 
285
291
  # Create client with LangChain config
@@ -292,7 +298,7 @@ vector_store = create_vector_store(
292
298
  cache_dir=config.vector_store_path,
293
299
  embedding_provider=config.embedding_provider,
294
300
  embedding_model=config.embedding_model,
295
- )
301
+ ) # raises VectorStoreCreationError on failure -- see the example above
296
302
 
297
303
  # Search for relevant endpoints
298
304
  results = vector_store.search("show me Tesla's financial metrics")
@@ -321,6 +327,42 @@ export FMP_EMBEDDING_MODEL=text-embedding-3-small
321
327
  - Automatic caching of embeddings
322
328
  - Persistent vector store for faster lookups
323
329
 
330
+ ### Tool argument names (LangChain vs MCP)
331
+
332
+ LangChain tools built from the vector store keep **API / wire** parameter names
333
+ (`from`, `to`, `periodLength`, `sicCode`, …). When the method shape is
334
+ compatible, those names are mapped onto the matching client method
335
+ (`from_date` / `start_date`, …) at invoke so method defaults and constraints
336
+ still apply (#172 / #186). If a required method parameter had no wire source,
337
+ LangChain would keep the wire schema and fall back to `client.request` instead
338
+ of the method — as of #188 no tool in the catalog does, so every LangChain tool
339
+ dispatches through a client method.
340
+
341
+ MCP tools expose the **Python method** parameter names instead (the signature
342
+ of `client.<module>.<method>`). The same endpoint can therefore show
343
+ `from`/`to` in a LangChain schema and `from_date`/`to_date` (or
344
+ `start_date`/`end_date`) on MCP — both are intentional.
345
+
346
+ The institutional Form 13F and symbol-positions-summary tools used to be the
347
+ exception, because their client methods required a `report_date` the wire does
348
+ not have. They now dispatch through `get_form_13f_by_quarter` and
349
+ `get_institutional_holdings_by_quarter`, whose `year`/`quarter` arguments match
350
+ the API (which rejects a request without them). The date-shaped
351
+ `get_form_13f(cik, report_date)` and
352
+ `get_institutional_holdings(symbol, report_date)` are unchanged and remain the
353
+ convenient Python entry points.
354
+
355
+ Both integrations resolve and bind through one module, `fmp_data.tool_binding`
356
+ — attribute-chain resolution, the wire→method name aliases, the
357
+ required-parameter coverage gate, and the invoke-time kwargs mapping. It lives
358
+ in the core package (no LangChain or MCP import), so the rules cannot drift
359
+ apart between the two (#188).
360
+
361
+ A catalogue-wide guard (`tests/unit/lc/test_endpoint_method_coverage.py`) fails
362
+ CI on *new* uncovered required method parameters or newly dropped mandatory
363
+ wire fields under method dispatch. Known cases are allowlisted in that test
364
+ (#188).
365
+
324
366
  ## Quick Start
325
367
 
326
368
  ```python
@@ -328,23 +370,23 @@ from fmp_data import FMPDataClient, ClientConfig, LoggingConfig
328
370
  from fmp_data.exceptions import FMPError, RateLimitError, AuthenticationError
329
371
 
330
372
  # Method 1: Initialize with direct API key
331
- client = FMPDataClient(api_key="your_api_key_here") # pragma: allowlist secret
373
+ client = FMPDataClient(api_key="your_api_key_here") # pragma: allowlist secret
332
374
 
333
375
  # Method 2: Initialize from environment variable (FMP_API_KEY)
334
376
  client = FMPDataClient.from_env()
335
377
 
336
378
  # Method 3: Initialize with custom configuration
337
379
  config = ClientConfig(
338
- api_key="your_api_key_here", #pragma: allowlist secret
380
+ api_key="your_api_key_here", # pragma: allowlist secret
339
381
  timeout=30,
340
382
  max_retries=3,
341
383
  base_url="https://financialmodelingprep.com",
342
- logging=LoggingConfig(level="INFO")
384
+ logging=LoggingConfig(level="INFO"),
343
385
  )
344
386
  client = FMPDataClient(config=config)
345
387
 
346
388
  # Using with context manager (recommended)
347
- with FMPDataClient(api_key="your_api_key_here") as client: # pragma: allowlist secret
389
+ with FMPDataClient(api_key="your_api_key_here") as client: # pragma: allowlist secret
348
390
  try:
349
391
  # Get company profile
350
392
  profile = client.company.get_profile("AAPL")
@@ -422,14 +464,11 @@ with FMPDataClient.from_env() as client:
422
464
  income_stmt = client.fundamental.get_income_statement(
423
465
  "AAPL",
424
466
  period="quarter", # or "annual"
425
- limit=4
467
+ limit=4,
426
468
  )
427
469
 
428
470
  # Get balance sheets
429
- balance_sheet = client.fundamental.get_balance_sheet(
430
- "AAPL",
431
- period="annual"
432
- )
471
+ balance_sheet = client.fundamental.get_balance_sheet("AAPL", period="annual")
433
472
 
434
473
  # Get cash flow statements
435
474
  cash_flow = client.fundamental.get_cash_flow("AAPL")
@@ -445,16 +484,11 @@ with FMPDataClient.from_env() as client:
445
484
 
446
485
  # Get historical prices
447
486
  history = client.company.get_historical_prices(
448
- symbol="TSLA",
449
- from_date=date(2023, 1, 1),
450
- to_date=date(2023, 12, 31)
487
+ symbol="TSLA", from_date=date(2023, 1, 1), to_date=date(2023, 12, 31)
451
488
  )
452
489
 
453
490
  # Get intraday prices
454
- intraday = client.company.get_intraday_prices(
455
- "TSLA",
456
- interval="5min"
457
- )
491
+ intraday = client.company.get_intraday_prices("TSLA", interval="5min")
458
492
  ```
459
493
 
460
494
  ### 4. Technical Indicators
@@ -464,25 +498,14 @@ from datetime import date
464
498
 
465
499
  with FMPDataClient.from_env() as client:
466
500
  # Simple Moving Average
467
- sma = client.technical.get_sma(
468
- "AAPL",
469
- period_length=20,
470
- timeframe="1day"
471
- )
501
+ sma = client.technical.get_sma("AAPL", period_length=20, timeframe="1day")
472
502
 
473
503
  # RSI (Relative Strength Index)
474
- rsi = client.technical.get_rsi(
475
- "AAPL",
476
- period_length=14,
477
- timeframe="1day"
478
- )
504
+ rsi = client.technical.get_rsi("AAPL", period_length=14, timeframe="1day")
479
505
 
480
506
  # MACD
481
507
  macd = client.technical.get_macd(
482
- "AAPL",
483
- fast_period=12,
484
- slow_period=26,
485
- signal_period=9
508
+ "AAPL", fast_period=12, slow_period=26, signal_period=9
486
509
  )
487
510
  ```
488
511
 
@@ -598,6 +621,7 @@ API reference in `docs/api/reference.md#async-client-usage`.
598
621
  from fmp_data import AsyncFMPDataClient
599
622
  import asyncio
600
623
 
624
+
601
625
  async def main():
602
626
  async with AsyncFMPDataClient.from_env() as client:
603
627
  # All endpoint methods are async
@@ -613,6 +637,7 @@ async def main():
613
637
  for p in profiles:
614
638
  print(f"{p.symbol}: {p.company_name}")
615
639
 
640
+
616
641
  asyncio.run(main())
617
642
  ```
618
643
 
@@ -645,7 +670,13 @@ FMP_MCP_MANIFEST=/path/to/custom/manifest.py
645
670
 
646
671
  ### Custom Configuration
647
672
  ```python
648
- from fmp_data import FMPDataClient, ClientConfig, LoggingConfig, RateLimitConfig, LogHandlerConfig
673
+ from fmp_data import (
674
+ FMPDataClient,
675
+ ClientConfig,
676
+ LoggingConfig,
677
+ RateLimitConfig,
678
+ LogHandlerConfig,
679
+ )
649
680
 
650
681
  config = ClientConfig(
651
682
  api_key="your_api_key_here", # pragma: allowlist secret
@@ -653,9 +684,7 @@ config = ClientConfig(
653
684
  max_retries=3,
654
685
  base_url="https://financialmodelingprep.com",
655
686
  rate_limit=RateLimitConfig(
656
- daily_limit=250,
657
- requests_per_second=10,
658
- requests_per_minute=300
687
+ daily_limit=250, requests_per_second=10, requests_per_minute=300
659
688
  ),
660
689
  logging=LoggingConfig(
661
690
  level="DEBUG",
@@ -663,7 +692,7 @@ config = ClientConfig(
663
692
  "console": LogHandlerConfig(
664
693
  class_name="StreamHandler",
665
694
  level="INFO",
666
- format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
695
+ format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
667
696
  ),
668
697
  "file": LogHandlerConfig(
669
698
  class_name="RotatingFileHandler",
@@ -672,11 +701,11 @@ config = ClientConfig(
672
701
  handler_kwargs={
673
702
  "filename": "fmp.log",
674
703
  "maxBytes": 10485760,
675
- "backupCount": 5
676
- }
677
- )
678
- }
679
- )
704
+ "backupCount": 5,
705
+ },
706
+ ),
707
+ },
708
+ ),
680
709
  )
681
710
 
682
711
  client = FMPDataClient(config=config)
@@ -689,15 +718,15 @@ The library provides a comprehensive exception hierarchy for robust error handli
689
718
  ```python
690
719
  from fmp_data import FMPDataClient
691
720
  from fmp_data.exceptions import (
692
- FMPError, # Base exception for all FMP errors
693
- RateLimitError, # API rate limit exceeded
694
- AuthenticationError, # Invalid or missing API key
695
- ValidationError, # Invalid request parameters
696
- ConfigError, # Configuration errors
697
- InvalidSymbolError, # Missing or blank required symbol
721
+ FMPError, # Base exception for all FMP errors
722
+ RateLimitError, # API rate limit exceeded
723
+ AuthenticationError, # Invalid or missing API key
724
+ ValidationError, # Invalid request parameters
725
+ ConfigError, # Configuration errors
726
+ InvalidSymbolError, # Missing or blank required symbol
698
727
  InvalidResponseTypeError, # Unexpected API response type
699
- DependencyError, # Missing optional dependency
700
- FMPNotFound, # Symbol or resource not found
728
+ DependencyError, # Missing optional dependency
729
+ FMPNotFound, # Symbol or resource not found
701
730
  )
702
731
 
703
732
  try:
@@ -33,6 +33,7 @@ from fmp_data.exceptions import (
33
33
  FMPError,
34
34
  RateLimitError,
35
35
  ValidationError,
36
+ VectorStoreCreationError,
36
37
  )
37
38
  from fmp_data.logger import FMPLogger
38
39
 
@@ -60,6 +61,7 @@ __all__ = [
60
61
  "RateLimitConfig",
61
62
  "RateLimitError",
62
63
  "ValidationError",
64
+ "VectorStoreCreationError",
63
65
  "__version__",
64
66
  "is_langchain_available",
65
67
  "logger",