fmp-data 2.5.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.5.0 → fmp_data-2.6.0}/.gitignore +3 -0
  2. {fmp_data-2.5.0 → fmp_data-2.6.0}/PKG-INFO +64 -22
  3. {fmp_data-2.5.0 → fmp_data-2.6.0}/README.md +50 -8
  4. {fmp_data-2.5.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.5.0 → fmp_data-2.6.0}/fmp_data/alternative/async_client.py +51 -9
  7. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/alternative/client.py +51 -9
  8. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/alternative/endpoints.py +13 -60
  9. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/alternative/mapping.py +28 -31
  10. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/alternative/models.py +4 -3
  11. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/alternative/schema.py +15 -5
  12. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/batch/endpoints.py +0 -29
  13. {fmp_data-2.5.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.5.0 → fmp_data-2.6.0}/fmp_data/company/async_client.py +107 -23
  16. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/company/client.py +107 -21
  17. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/company/endpoints.py +49 -165
  18. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/company/hints.py +0 -22
  19. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/company/mapping.py +55 -2
  20. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/company/models.py +12 -11
  21. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/economics/endpoints.py +1 -26
  22. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/economics/mapping.py +1 -21
  23. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/economics/models.py +4 -3
  24. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/exceptions.py +51 -0
  25. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/fundamental/async_client.py +20 -4
  26. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/fundamental/client.py +20 -2
  27. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/fundamental/endpoints.py +4 -52
  28. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/fundamental/mapping.py +22 -77
  29. {fmp_data-2.5.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.5.0 → fmp_data-2.6.0}/fmp_data/index/models.py +3 -1
  32. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/institutional/async_client.py +206 -53
  33. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/institutional/client.py +242 -49
  34. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/institutional/endpoints.py +34 -91
  35. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/institutional/mapping.py +43 -91
  36. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/institutional/models.py +37 -27
  37. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/institutional/schema.py +3 -2
  38. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/intelligence/async_client.py +23 -11
  39. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/intelligence/client.py +23 -11
  40. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/intelligence/endpoints.py +8 -102
  41. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/intelligence/mapping.py +31 -52
  42. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/intelligence/models.py +24 -21
  43. {fmp_data-2.5.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.5.0 → fmp_data-2.6.0}/fmp_data/investment/endpoints.py +43 -28
  46. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/investment/mapping.py +53 -47
  47. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/investment/models.py +6 -4
  48. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/investment/schema.py +19 -5
  49. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/lc/__init__.py +54 -35
  50. fmp_data-2.6.0/fmp_data/lc/hints.py +503 -0
  51. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/lc/models.py +25 -0
  52. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/lc/registry.py +227 -48
  53. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/lc/vector_store.py +413 -64
  54. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/market/async_client.py +54 -12
  55. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/market/client.py +54 -12
  56. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/market/endpoints.py +25 -90
  57. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/market/mapping.py +8 -0
  58. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/market/models.py +7 -5
  59. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/market/schema.py +26 -9
  60. fmp_data-2.6.0/fmp_data/mcp/cli.py +1270 -0
  61. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/mcp/discovery.py +10 -1
  62. fmp_data-2.6.0/fmp_data/mcp/tool_loader.py +468 -0
  63. fmp_data-2.6.0/fmp_data/mcp/tools_manifest.py +297 -0
  64. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/models.py +242 -10
  65. fmp_data-2.6.0/fmp_data/schema.py +278 -0
  66. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/sec/async_client.py +6 -4
  67. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/sec/client.py +4 -4
  68. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/sec/endpoints.py +17 -44
  69. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/sec/mapping.py +80 -11
  70. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/sec/models.py +8 -6
  71. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/technical/endpoints.py +0 -55
  72. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/technical/mapping.py +11 -44
  73. fmp_data-2.6.0/fmp_data/tool_binding.py +352 -0
  74. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/transcripts/endpoints.py +0 -7
  75. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/transcripts/mapping.py +14 -3
  76. {fmp_data-2.5.0 → fmp_data-2.6.0}/pyproject.toml +44 -25
  77. fmp_data-2.6.0/tests/e2e/test_live_signatures.py +619 -0
  78. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_lc.py +19 -14
  79. fmp_data-2.6.0/tests/unit/lc/__init__.py +0 -0
  80. fmp_data-2.6.0/tests/unit/lc/test_deprecated_endpoints.py +296 -0
  81. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/lc/test_endpoint_based_rules.py +0 -2
  82. fmp_data-2.6.0/tests/unit/lc/test_endpoint_method_coverage.py +314 -0
  83. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/lc/test_mapping.py +23 -16
  84. fmp_data-2.6.0/tests/unit/lc/test_method_dispatch.py +654 -0
  85. fmp_data-2.6.0/tests/unit/lc/test_tool_schema.py +302 -0
  86. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/lc/test_validation_registry.py +155 -2
  87. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/lc/test_vector_store.py +13 -6
  88. fmp_data-2.6.0/tests/unit/test_arg_model_deprecation.py +402 -0
  89. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_async_clients.py +382 -65
  90. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_base.py +0 -2
  91. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_base_async.py +0 -1
  92. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_cache_backends.py +2 -2
  93. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_cache_integration.py +3 -3
  94. fmp_data-2.6.0/tests/unit/test_cache_ttl_override_keys.py +166 -0
  95. fmp_data-2.6.0/tests/unit/test_catalog_registration.py +517 -0
  96. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_company.py +11 -8
  97. fmp_data-2.6.0/tests/unit/test_datetime_shadowing.py +121 -0
  98. fmp_data-2.6.0/tests/unit/test_deprecated_endpoint_flags.py +148 -0
  99. fmp_data-2.6.0/tests/unit/test_deprecated_methods_warn.py +287 -0
  100. fmp_data-2.6.0/tests/unit/test_docs_endpoints_sync.py +301 -0
  101. fmp_data-2.6.0/tests/unit/test_helpers.py +537 -0
  102. fmp_data-2.6.0/tests/unit/test_hint_consolidation.py +537 -0
  103. fmp_data-2.6.0/tests/unit/test_imports.py +110 -0
  104. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_institutional.py +433 -0
  105. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_intelligence.py +6 -8
  106. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_investment.py +87 -16
  107. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_market.py +13 -11
  108. fmp_data-2.6.0/tests/unit/test_mcp.py +1614 -0
  109. fmp_data-2.6.0/tests/unit/test_mcp_cli.py +1103 -0
  110. fmp_data-2.6.0/tests/unit/test_mcp_entry_point_coherence.py +774 -0
  111. fmp_data-2.6.0/tests/unit/test_models.py +570 -0
  112. fmp_data-2.6.0/tests/unit/test_param_required_consistency.py +413 -0
  113. fmp_data-2.6.0/tests/unit/test_tool_binding.py +435 -0
  114. fmp_data-2.6.0/tests/unit/test_vector_store_error_contract.py +191 -0
  115. fmp_data-2.5.0/fmp_data/cache/config.py +0 -58
  116. fmp_data-2.5.0/fmp_data/helpers.py +0 -92
  117. fmp_data-2.5.0/fmp_data/investment/client.py +0 -157
  118. fmp_data-2.5.0/fmp_data/lc/hints.py +0 -134
  119. fmp_data-2.5.0/fmp_data/mcp/cli.py +0 -485
  120. fmp_data-2.5.0/fmp_data/mcp/tool_loader.py +0 -147
  121. fmp_data-2.5.0/fmp_data/mcp/tools_manifest.py +0 -214
  122. fmp_data-2.5.0/fmp_data/schema.py +0 -165
  123. fmp_data-2.5.0/tests/unit/test_catalog_registration.py +0 -243
  124. fmp_data-2.5.0/tests/unit/test_helpers.py +0 -141
  125. fmp_data-2.5.0/tests/unit/test_mcp.py +0 -780
  126. fmp_data-2.5.0/tests/unit/test_mcp_cli.py +0 -489
  127. fmp_data-2.5.0/tests/unit/test_models.py +0 -241
  128. {fmp_data-2.5.0 → fmp_data-2.6.0}/LICENSE +0 -0
  129. {fmp_data-2.5.0 → fmp_data-2.6.0}/NOTICE +0 -0
  130. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/alternative/__init__.py +0 -0
  131. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/async_client.py +0 -0
  132. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/base.py +0 -0
  133. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/batch/__init__.py +0 -0
  134. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/batch/_csv_utils.py +0 -0
  135. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/batch/async_client.py +0 -0
  136. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/batch/client.py +0 -0
  137. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/batch/models.py +0 -0
  138. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/cache/__init__.py +0 -0
  139. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/cache/base.py +0 -0
  140. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/cache/file.py +0 -0
  141. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/cache/memory.py +0 -0
  142. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/cache/redis_backend.py +0 -0
  143. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/client.py +0 -0
  144. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/company/__init__.py +0 -0
  145. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/company/schema.py +0 -0
  146. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/config.py +0 -0
  147. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/economics/__init__.py +0 -0
  148. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/economics/async_client.py +0 -0
  149. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/economics/client.py +0 -0
  150. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/economics/schema.py +0 -0
  151. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/fundamental/__init__.py +0 -0
  152. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/fundamental/schema.py +0 -0
  153. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/index/__init__.py +0 -0
  154. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/index/async_client.py +0 -0
  155. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/index/client.py +0 -0
  156. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/index/endpoints.py +0 -0
  157. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/index/mapping.py +0 -0
  158. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/institutional/__init__.py +0 -0
  159. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/intelligence/__init__.py +0 -0
  160. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/intelligence/schema.py +0 -0
  161. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/investment/__init__.py +0 -0
  162. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/lc/config.py +0 -0
  163. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/lc/embedding.py +0 -0
  164. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/lc/mapping.py +0 -0
  165. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/lc/utils.py +0 -0
  166. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/lc/validation.py +0 -0
  167. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/logger.py +0 -0
  168. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/market/__init__.py +0 -0
  169. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/market/hints.py +0 -0
  170. {fmp_data-2.5.0/tests/unit/lc → fmp_data-2.6.0/fmp_data/mcp}/__init__.py +0 -0
  171. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/mcp/__main__.py +0 -0
  172. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/mcp/_compat.py +0 -0
  173. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/mcp/server.py +0 -0
  174. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/mcp/setup.py +0 -0
  175. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/mcp/utils.py +0 -0
  176. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/py.typed +0 -0
  177. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/rate_limit.py +0 -0
  178. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/sec/__init__.py +0 -0
  179. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/technical/__init__.py +0 -0
  180. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/technical/async_client.py +0 -0
  181. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/technical/client.py +0 -0
  182. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/technical/models.py +0 -0
  183. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/technical/schema.py +0 -0
  184. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/transcripts/__init__.py +0 -0
  185. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/transcripts/async_client.py +0 -0
  186. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/transcripts/client.py +0 -0
  187. {fmp_data-2.5.0 → fmp_data-2.6.0}/fmp_data/transcripts/models.py +0 -0
  188. {fmp_data-2.5.0/tests/unit → fmp_data-2.6.0/tests}/__init__.py +0 -0
  189. {fmp_data-2.5.0/tests/integration → fmp_data-2.6.0/tests/e2e}/__init__.py +0 -0
  190. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/examples/__init__.py +0 -0
  191. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/examples/test_examples_smoke.py +0 -0
  192. {fmp_data-2.5.0/tests → fmp_data-2.6.0/tests/integration}/__init__.py +0 -0
  193. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/base.py +0 -0
  194. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/conftest.py +0 -0
  195. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_alternative.py +0 -0
  196. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_batch.py +0 -0
  197. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_company.py +0 -0
  198. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_economics.py +0 -0
  199. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_fundamental.py +0 -0
  200. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_index.py +0 -0
  201. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_institutional.py +0 -0
  202. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_intelligence.py +0 -0
  203. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_investment.py +0 -0
  204. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_market.py +0 -0
  205. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_sec.py +0 -0
  206. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_technical.py +0 -0
  207. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/integration/test_transcripts.py +0 -0
  208. {fmp_data-2.5.0/fmp_data/mcp → fmp_data-2.6.0/tests/unit}/__init__.py +0 -0
  209. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/conftest.py +0 -0
  210. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/lc/conftest.py +0 -0
  211. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/lc/test_config.py +0 -0
  212. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/lc/test_embedding.py +0 -0
  213. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/lc/test_imports.py +0 -0
  214. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/lc/test_models.py +0 -0
  215. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/lc/test_utils.py +0 -0
  216. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_alternative.py +0 -0
  217. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_alternative_coverage.py +0 -0
  218. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_base_coverage.py +0 -0
  219. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_batch.py +0 -0
  220. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_cassette_contracts.py +0 -0
  221. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_client.py +0 -0
  222. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_company_coverage.py +0 -0
  223. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_config.py +0 -0
  224. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_docs_tools_sync.py +0 -0
  225. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_economics.py +0 -0
  226. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_endpoint_registry.py +0 -0
  227. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_exceptions.py +0 -0
  228. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_fundamental.py +0 -0
  229. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_index.py +0 -0
  230. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_logger.py +0 -0
  231. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_rate_limit.py +0 -0
  232. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_rate_limit_async.py +0 -0
  233. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_rate_limit_coverage.py +0 -0
  234. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_sec.py +0 -0
  235. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_technical.py +0 -0
  236. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_technical_coverage.py +0 -0
  237. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_transcripts.py +0 -0
  238. {fmp_data-2.5.0 → fmp_data-2.6.0}/tests/unit/test_vcr_sanitization.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.5.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,13 +293,19 @@ 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 = [
@@ -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
@@ -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,13 +223,19 @@ 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 = [
@@ -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
@@ -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",
@@ -0,0 +1,24 @@
1
+ # file generated by vcs-versioning
2
+ # don't change, don't track in version control
3
+ from __future__ import annotations
4
+
5
+ __all__ = [
6
+ "__version__",
7
+ "__version_tuple__",
8
+ "version",
9
+ "version_tuple",
10
+ "__commit_id__",
11
+ "commit_id",
12
+ ]
13
+
14
+ version: str
15
+ __version__: str
16
+ __version_tuple__: tuple[int | str, ...]
17
+ version_tuple: tuple[int | str, ...]
18
+ commit_id: str | None
19
+ __commit_id__: str | None
20
+
21
+ __version__ = version = '2.6.0'
22
+ __version_tuple__ = version_tuple = (2, 6, 0)
23
+
24
+ __commit_id__ = commit_id = None
@@ -8,7 +8,6 @@ from pydantic import BaseModel
8
8
 
9
9
  from fmp_data.alternative.endpoints import (
10
10
  COMMODITIES_LIST,
11
- COMMODITIES_QUOTES,
12
11
  COMMODITY_HISTORICAL,
13
12
  COMMODITY_INTRADAY,
14
13
  COMMODITY_QUOTE,
@@ -16,12 +15,10 @@ from fmp_data.alternative.endpoints import (
16
15
  CRYPTO_INTRADAY,
17
16
  CRYPTO_LIST,
18
17
  CRYPTO_QUOTE,
19
- CRYPTO_QUOTES,
20
18
  FOREX_HISTORICAL,
21
19
  FOREX_INTRADAY,
22
20
  FOREX_LIST,
23
21
  FOREX_QUOTE,
24
- FOREX_QUOTES,
25
22
  )
26
23
  from fmp_data.alternative.models import (
27
24
  Commodity,
@@ -38,6 +35,7 @@ from fmp_data.alternative.models import (
38
35
  ForexQuote,
39
36
  )
40
37
  from fmp_data.base import AsyncEndpointGroup
38
+ from fmp_data.helpers import deprecated
41
39
 
42
40
  ModelT = TypeVar("ModelT", bound=BaseModel)
43
41
 
@@ -56,9 +54,25 @@ class AsyncAlternativeMarketsClient(AsyncEndpointGroup):
56
54
  """Get list of available cryptocurrencies"""
57
55
  return await self.client.request_async(CRYPTO_LIST)
58
56
 
57
+ @deprecated(
58
+ "quotes/crypto is dead. The live path batch-crypto-quotes is already "
59
+ "shipped as FMPDataClient.batch.get_crypto_quotes(); this method is a "
60
+ "leftover declaration, not a second data source. The payload is "
61
+ "narrower -- symbol, price, change and volume only."
62
+ )
59
63
  async def get_crypto_quotes(self) -> list[CryptoQuote]:
60
- """Get cryptocurrency quotes"""
61
- return await self.client.request_async(CRYPTO_QUOTES)
64
+ """Get cryptocurrency quotes
65
+
66
+ .. deprecated::
67
+ ``quotes/crypto`` 404s and will be removed in a future version. It
68
+ currently returns an empty list. Use
69
+ ``client.batch.get_crypto_quotes()``, which serves the live
70
+ ``batch-crypto-quotes``. It is not a drop-in: that endpoint
71
+ returns only ``symbol``/``price``/``change``/``volume``, so the day
72
+ range, market cap and moving averages declared on
73
+ :class:`~fmp_data.alternative.models.CryptoQuote` are unavailable.
74
+ """
75
+ return []
62
76
 
63
77
  async def get_crypto_quote(self, symbol: str) -> CryptoQuote:
64
78
  """Get cryptocurrency quote"""
@@ -94,9 +108,23 @@ class AsyncAlternativeMarketsClient(AsyncEndpointGroup):
94
108
  """Get list of available forex pairs"""
95
109
  return await self.client.request_async(FOREX_LIST)
96
110
 
111
+ @deprecated(
112
+ "quotes/forex is dead. The live path batch-forex-quotes is already "
113
+ "shipped as FMPDataClient.batch.get_forex_quotes(); this method is a "
114
+ "leftover declaration, not a second data source. The payload is "
115
+ "narrower -- symbol, price, change and volume only."
116
+ )
97
117
  async def get_forex_quotes(self) -> list[ForexQuote]:
98
- """Get forex quotes"""
99
- return await self.client.request_async(FOREX_QUOTES)
118
+ """Get forex quotes
119
+
120
+ .. deprecated::
121
+ ``quotes/forex`` 404s and will be removed in a future version. It
122
+ currently returns an empty list. Use
123
+ ``client.batch.get_forex_quotes()``, which serves the live
124
+ ``batch-forex-quotes``. It is not a drop-in: that endpoint returns
125
+ only ``symbol``/``price``/``change``/``volume``.
126
+ """
127
+ return []
100
128
 
101
129
  async def get_forex_quote(self, symbol: str) -> ForexQuote:
102
130
  """Get forex quote"""
@@ -132,9 +160,23 @@ class AsyncAlternativeMarketsClient(AsyncEndpointGroup):
132
160
  """Get list of available commodities"""
133
161
  return await self.client.request_async(COMMODITIES_LIST)
134
162
 
163
+ @deprecated(
164
+ "quotes/commodity is dead. The live path batch-commodity-quotes is "
165
+ "already shipped as FMPDataClient.batch.get_commodity_quotes(); this "
166
+ "method is a leftover declaration, not a second data source. The "
167
+ "payload is narrower -- symbol, price, change and volume only."
168
+ )
135
169
  async def get_commodities_quotes(self) -> list[CommodityQuote]:
136
- """Get commodities quotes"""
137
- return await self.client.request_async(COMMODITIES_QUOTES)
170
+ """Get commodities quotes
171
+
172
+ .. deprecated::
173
+ ``quotes/commodity`` 404s and will be removed in a future version.
174
+ It currently returns an empty list. Use
175
+ ``client.batch.get_commodity_quotes()``, which serves the live
176
+ ``batch-commodity-quotes``. It is not a drop-in: that endpoint
177
+ returns only ``symbol``/``price``/``change``/``volume``.
178
+ """
179
+ return []
138
180
 
139
181
  async def get_commodity_quote(self, symbol: str) -> CommodityQuote:
140
182
  """Get commodity quote"""
@@ -6,7 +6,6 @@ from pydantic import BaseModel
6
6
 
7
7
  from fmp_data.alternative.endpoints import (
8
8
  COMMODITIES_LIST,
9
- COMMODITIES_QUOTES,
10
9
  COMMODITY_HISTORICAL,
11
10
  COMMODITY_INTRADAY,
12
11
  COMMODITY_QUOTE,
@@ -14,12 +13,10 @@ from fmp_data.alternative.endpoints import (
14
13
  CRYPTO_INTRADAY,
15
14
  CRYPTO_LIST,
16
15
  CRYPTO_QUOTE,
17
- CRYPTO_QUOTES,
18
16
  FOREX_HISTORICAL,
19
17
  FOREX_INTRADAY,
20
18
  FOREX_LIST,
21
19
  FOREX_QUOTE,
22
- FOREX_QUOTES,
23
20
  )
24
21
  from fmp_data.alternative.models import (
25
22
  Commodity,
@@ -36,6 +33,7 @@ from fmp_data.alternative.models import (
36
33
  ForexQuote,
37
34
  )
38
35
  from fmp_data.base import EndpointGroup
36
+ from fmp_data.helpers import deprecated
39
37
 
40
38
  ModelT = TypeVar("ModelT", bound=BaseModel)
41
39
 
@@ -54,9 +52,25 @@ class AlternativeMarketsClient(EndpointGroup):
54
52
  """Get list of available cryptocurrencies"""
55
53
  return self.client.request(CRYPTO_LIST)
56
54
 
55
+ @deprecated(
56
+ "quotes/crypto is dead. The live path batch-crypto-quotes is already "
57
+ "shipped as FMPDataClient.batch.get_crypto_quotes(); this method is a "
58
+ "leftover declaration, not a second data source. The payload is "
59
+ "narrower -- symbol, price, change and volume only."
60
+ )
57
61
  def get_crypto_quotes(self) -> list[CryptoQuote]:
58
- """Get cryptocurrency quotes"""
59
- return self.client.request(CRYPTO_QUOTES)
62
+ """Get cryptocurrency quotes
63
+
64
+ .. deprecated::
65
+ ``quotes/crypto`` 404s and will be removed in a future version. It
66
+ currently returns an empty list. Use
67
+ ``client.batch.get_crypto_quotes()``, which serves the live
68
+ ``batch-crypto-quotes``. It is not a drop-in: that endpoint
69
+ returns only ``symbol``/``price``/``change``/``volume``, so the day
70
+ range, market cap and moving averages declared on
71
+ :class:`~fmp_data.alternative.models.CryptoQuote` are unavailable.
72
+ """
73
+ return []
60
74
 
61
75
  def get_crypto_quote(self, symbol: str) -> CryptoQuote:
62
76
  """Get cryptocurrency quote"""
@@ -90,9 +104,23 @@ class AlternativeMarketsClient(EndpointGroup):
90
104
  """Get list of available forex pairs"""
91
105
  return self.client.request(FOREX_LIST)
92
106
 
107
+ @deprecated(
108
+ "quotes/forex is dead. The live path batch-forex-quotes is already "
109
+ "shipped as FMPDataClient.batch.get_forex_quotes(); this method is a "
110
+ "leftover declaration, not a second data source. The payload is "
111
+ "narrower -- symbol, price, change and volume only."
112
+ )
93
113
  def get_forex_quotes(self) -> list[ForexQuote]:
94
- """Get forex quotes"""
95
- return self.client.request(FOREX_QUOTES)
114
+ """Get forex quotes
115
+
116
+ .. deprecated::
117
+ ``quotes/forex`` 404s and will be removed in a future version. It
118
+ currently returns an empty list. Use
119
+ ``client.batch.get_forex_quotes()``, which serves the live
120
+ ``batch-forex-quotes``. It is not a drop-in: that endpoint returns
121
+ only ``symbol``/``price``/``change``/``volume``.
122
+ """
123
+ return []
96
124
 
97
125
  def get_forex_quote(self, symbol: str) -> ForexQuote:
98
126
  """Get forex quote"""
@@ -126,9 +154,23 @@ class AlternativeMarketsClient(EndpointGroup):
126
154
  """Get list of available commodities"""
127
155
  return self.client.request(COMMODITIES_LIST)
128
156
 
157
+ @deprecated(
158
+ "quotes/commodity is dead. The live path batch-commodity-quotes is "
159
+ "already shipped as FMPDataClient.batch.get_commodity_quotes(); this "
160
+ "method is a leftover declaration, not a second data source. The "
161
+ "payload is narrower -- symbol, price, change and volume only."
162
+ )
129
163
  def get_commodities_quotes(self) -> list[CommodityQuote]:
130
- """Get commodities quotes"""
131
- return self.client.request(COMMODITIES_QUOTES)
164
+ """Get commodities quotes
165
+
166
+ .. deprecated::
167
+ ``quotes/commodity`` 404s and will be removed in a future version.
168
+ It currently returns an empty list. Use
169
+ ``client.batch.get_commodity_quotes()``, which serves the live
170
+ ``batch-commodity-quotes``. It is not a drop-in: that endpoint
171
+ returns only ``symbol``/``price``/``change``/``volume``.
172
+ """
173
+ return []
132
174
 
133
175
  def get_commodity_quote(self, symbol: str) -> CommodityQuote:
134
176
  """Get commodity quote"""