fmp-data 2.7.1__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 (272) hide show
  1. {fmp_data-2.7.1 → fmp_data-2.9.0}/PKG-INFO +32 -25
  2. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/__init__.py +4 -0
  3. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/_version.py +2 -2
  4. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/alternative/async_client.py +108 -9
  5. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/alternative/client.py +114 -9
  6. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/alternative/endpoints.py +60 -3
  7. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/alternative/mapping.py +8 -2
  8. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/base.py +19 -5
  9. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/batch/models.py +3 -1
  10. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/company/async_client.py +148 -11
  11. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/company/client.py +161 -13
  12. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/company/endpoints.py +56 -2
  13. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/company/mapping.py +41 -3
  14. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/company/models.py +3 -1
  15. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/economics/async_client.py +71 -6
  16. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/economics/client.py +69 -6
  17. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/economics/endpoints.py +28 -1
  18. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/economics/mapping.py +15 -1
  19. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/exceptions.py +25 -6
  20. fmp_data-2.9.0/fmp_data/fundamental/async_client.py +380 -0
  21. fmp_data-2.9.0/fmp_data/fundamental/client.py +373 -0
  22. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/fundamental/endpoints.py +346 -2
  23. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/fundamental/mapping.py +9 -3
  24. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/index/models.py +8 -1
  25. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/institutional/async_client.py +32 -3
  26. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/institutional/client.py +30 -3
  27. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/institutional/endpoints.py +8 -1
  28. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/institutional/mapping.py +5 -2
  29. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/institutional/models.py +16 -4
  30. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/intelligence/async_client.py +379 -20
  31. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/intelligence/client.py +392 -21
  32. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/intelligence/endpoints.py +304 -3
  33. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/intelligence/mapping.py +232 -4
  34. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/intelligence/models.py +138 -2
  35. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/investment/async_client.py +10 -2
  36. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/investment/client.py +15 -3
  37. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/lc/hints.py +42 -0
  38. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/market/async_client.py +249 -24
  39. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/market/client.py +249 -24
  40. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/market/endpoints.py +75 -5
  41. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/market/mapping.py +25 -12
  42. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/market/models.py +3 -1
  43. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/mcp/_compat.py +7 -4
  44. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/mcp/tools_manifest.py +8 -1
  45. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/models.py +4 -0
  46. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/sec/async_client.py +29 -2
  47. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/sec/client.py +29 -2
  48. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/sec/endpoints.py +18 -1
  49. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/sec/mapping.py +18 -1
  50. {fmp_data-2.7.1 → fmp_data-2.9.0}/pyproject.toml +66 -50
  51. fmp_data-2.9.0/tests/fixtures/provider_optional_parameters.json +1304 -0
  52. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_institutional.py +2 -2
  53. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_market.py +1 -1
  54. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_endpoint_method_coverage.py +53 -2
  55. fmp_data-2.9.0/tests/unit/lc/test_provider_optional_tools.py +90 -0
  56. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_base.py +21 -3
  57. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_exceptions.py +37 -0
  58. fmp_data-2.9.0/tests/unit/test_fmp_29_surface.py +104 -0
  59. fmp_data-2.9.0/tests/unit/test_insider_statistics_fractional.py +209 -0
  60. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_market.py +2 -2
  61. fmp_data-2.9.0/tests/unit/test_mcp_optional_parameters.py +55 -0
  62. fmp_data-2.9.0/tests/unit/test_provider_optional_parameters.py +237 -0
  63. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_setup_uv_pin.py +4 -4
  64. fmp_data-2.7.1/fmp_data/fundamental/async_client.py +0 -184
  65. fmp_data-2.7.1/fmp_data/fundamental/client.py +0 -168
  66. {fmp_data-2.7.1 → fmp_data-2.9.0}/.gitignore +0 -0
  67. {fmp_data-2.7.1 → fmp_data-2.9.0}/LICENSE +0 -0
  68. {fmp_data-2.7.1 → fmp_data-2.9.0}/NOTICE +0 -0
  69. {fmp_data-2.7.1 → fmp_data-2.9.0}/README.md +0 -0
  70. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/_redaction.py +0 -0
  71. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/alternative/__init__.py +0 -0
  72. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/alternative/models.py +0 -0
  73. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/alternative/schema.py +0 -0
  74. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/async_client.py +0 -0
  75. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/batch/__init__.py +0 -0
  76. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/batch/_csv_utils.py +0 -0
  77. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/batch/async_client.py +0 -0
  78. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/batch/client.py +0 -0
  79. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/batch/endpoints.py +0 -0
  80. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/batch/mapping.py +0 -0
  81. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/cache/__init__.py +0 -0
  82. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/cache/base.py +0 -0
  83. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/cache/config.py +0 -0
  84. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/cache/file.py +0 -0
  85. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/cache/memory.py +0 -0
  86. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/cache/redis_backend.py +0 -0
  87. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/client.py +0 -0
  88. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/company/__init__.py +0 -0
  89. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/company/hints.py +0 -0
  90. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/company/schema.py +0 -0
  91. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/config.py +0 -0
  92. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/economics/__init__.py +0 -0
  93. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/economics/models.py +0 -0
  94. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/economics/schema.py +0 -0
  95. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/fundamental/__init__.py +0 -0
  96. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/fundamental/models.py +0 -0
  97. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/fundamental/schema.py +0 -0
  98. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/helpers.py +0 -0
  99. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/index/__init__.py +0 -0
  100. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/index/async_client.py +0 -0
  101. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/index/client.py +0 -0
  102. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/index/endpoints.py +0 -0
  103. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/index/mapping.py +0 -0
  104. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/institutional/__init__.py +0 -0
  105. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/institutional/schema.py +0 -0
  106. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/intelligence/__init__.py +0 -0
  107. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/intelligence/schema.py +0 -0
  108. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/investment/__init__.py +0 -0
  109. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/investment/endpoints.py +0 -0
  110. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/investment/mapping.py +0 -0
  111. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/investment/models.py +0 -0
  112. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/investment/schema.py +0 -0
  113. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/lc/__init__.py +0 -0
  114. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/lc/config.py +0 -0
  115. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/lc/embedding.py +0 -0
  116. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/lc/mapping.py +0 -0
  117. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/lc/models.py +0 -0
  118. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/lc/registry.py +0 -0
  119. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/lc/utils.py +0 -0
  120. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/lc/validation.py +0 -0
  121. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/lc/vector_store.py +0 -0
  122. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/logger.py +0 -0
  123. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/market/__init__.py +0 -0
  124. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/market/hints.py +0 -0
  125. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/market/schema.py +0 -0
  126. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/mcp/__init__.py +0 -0
  127. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/mcp/__main__.py +0 -0
  128. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/mcp/cli.py +0 -0
  129. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/mcp/discovery.py +0 -0
  130. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/mcp/server.py +0 -0
  131. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/mcp/setup.py +0 -0
  132. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/mcp/tool_loader.py +0 -0
  133. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/mcp/utils.py +0 -0
  134. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/py.typed +0 -0
  135. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/rate_limit.py +0 -0
  136. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/schema.py +0 -0
  137. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/sec/__init__.py +0 -0
  138. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/sec/models.py +0 -0
  139. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/technical/__init__.py +0 -0
  140. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/technical/async_client.py +0 -0
  141. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/technical/client.py +0 -0
  142. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/technical/endpoints.py +0 -0
  143. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/technical/mapping.py +0 -0
  144. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/technical/models.py +0 -0
  145. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/technical/schema.py +0 -0
  146. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/tool_binding.py +0 -0
  147. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/transcripts/__init__.py +0 -0
  148. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/transcripts/async_client.py +0 -0
  149. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/transcripts/client.py +0 -0
  150. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/transcripts/endpoints.py +0 -0
  151. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/transcripts/mapping.py +0 -0
  152. {fmp_data-2.7.1 → fmp_data-2.9.0}/fmp_data/transcripts/models.py +0 -0
  153. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/__init__.py +0 -0
  154. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/e2e/__init__.py +0 -0
  155. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/e2e/harness.py +0 -0
  156. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/e2e/test_client_sweep.py +0 -0
  157. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/e2e/test_live_signatures.py +0 -0
  158. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/examples/__init__.py +0 -0
  159. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/examples/test_examples_smoke.py +0 -0
  160. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/__init__.py +0 -0
  161. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/base.py +0 -0
  162. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/cassette_contracts.json +0 -0
  163. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/conftest.py +0 -0
  164. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_alternative.py +0 -0
  165. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_batch.py +0 -0
  166. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_company.py +0 -0
  167. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_economics.py +0 -0
  168. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_fundamental.py +0 -0
  169. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_index.py +0 -0
  170. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_intelligence.py +0 -0
  171. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_investment.py +0 -0
  172. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_lc.py +0 -0
  173. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_sec.py +0 -0
  174. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_technical.py +0 -0
  175. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/integration/test_transcripts.py +0 -0
  176. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/__init__.py +0 -0
  177. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/conftest.py +0 -0
  178. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/__init__.py +0 -0
  179. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/conftest.py +0 -0
  180. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_config.py +0 -0
  181. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_deprecated_endpoints.py +0 -0
  182. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_embedding.py +0 -0
  183. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_endpoint_based_rules.py +0 -0
  184. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_imports.py +0 -0
  185. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_mapping.py +0 -0
  186. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_method_dispatch.py +0 -0
  187. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_models.py +0 -0
  188. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_package_init.py +0 -0
  189. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_tool_schema.py +0 -0
  190. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_utils.py +0 -0
  191. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_validation.py +0 -0
  192. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_validation_registry.py +0 -0
  193. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/lc/test_vector_store.py +0 -0
  194. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_alternative.py +0 -0
  195. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_alternative_coverage.py +0 -0
  196. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_arg_model_deprecation.py +0 -0
  197. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_artifact_action_pins.py +0 -0
  198. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_async_clients.py +0 -0
  199. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_bandit_skips.py +0 -0
  200. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_base_async.py +0 -0
  201. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_base_coverage.py +0 -0
  202. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_batch.py +0 -0
  203. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_bulk_bytes.py +0 -0
  204. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_cache_backends.py +0 -0
  205. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_cache_integration.py +0 -0
  206. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_cache_ttl_override_keys.py +0 -0
  207. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_cassette_contracts.py +0 -0
  208. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_catalog_registration.py +0 -0
  209. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_changelog_headings.py +0 -0
  210. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_checkout_credentials.py +0 -0
  211. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_ci_quality_gates.py +0 -0
  212. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_client.py +0 -0
  213. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_closed_vocabularies.py +0 -0
  214. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_codeql_workflow.py +0 -0
  215. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_company.py +0 -0
  216. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_company_coverage.py +0 -0
  217. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_config.py +0 -0
  218. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_config_secret_serialization.py +0 -0
  219. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_datetime_shadowing.py +0 -0
  220. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_dependabot_action_groups.py +0 -0
  221. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_deprecated_endpoint_flags.py +0 -0
  222. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_deprecated_methods_warn.py +0 -0
  223. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_docs_endpoints_sync.py +0 -0
  224. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_docs_tools_sync.py +0 -0
  225. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_e2e_harness.py +0 -0
  226. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_e2e_sweep.py +0 -0
  227. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_economics.py +0 -0
  228. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_endpoint_registry.py +0 -0
  229. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_example_json_fences.py +0 -0
  230. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_export_dotenv.py +0 -0
  231. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_extras_coverage_gate.py +0 -0
  232. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_fundamental.py +0 -0
  233. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_github_release_notes.py +0 -0
  234. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_helpers.py +0 -0
  235. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_hint_consolidation.py +0 -0
  236. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_hosted_mcp_docs.py +0 -0
  237. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_imports.py +0 -0
  238. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_index.py +0 -0
  239. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_institutional.py +0 -0
  240. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_intelligence.py +0 -0
  241. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_investment.py +0 -0
  242. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_list_unwrap.py +0 -0
  243. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_logger.py +0 -0
  244. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_mcp.py +0 -0
  245. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_mcp_cli.py +0 -0
  246. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_mcp_config_perms.py +0 -0
  247. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_mcp_entry_point_coherence.py +0 -0
  248. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_mcp_setup.py +0 -0
  249. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_mcp_utils.py +0 -0
  250. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_models.py +0 -0
  251. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_param_required_consistency.py +0 -0
  252. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_path_params.py +0 -0
  253. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_publish_pins.py +0 -0
  254. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_rate_limit.py +0 -0
  255. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_rate_limit_async.py +0 -0
  256. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_rate_limit_coverage.py +0 -0
  257. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_redaction_rules.py +0 -0
  258. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_redis_backend.py +0 -0
  259. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_release_pr_workflow.py +0 -0
  260. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_release_tag_push.py +0 -0
  261. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_sec.py +0 -0
  262. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_secret_scan_ci.py +0 -0
  263. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_security_audit_pins.py +0 -0
  264. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_tag_ancestry_guard.py +0 -0
  265. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_technical.py +0 -0
  266. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_technical_coverage.py +0 -0
  267. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_tool_binding.py +0 -0
  268. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_transcripts.py +0 -0
  269. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_vcr_sanitization.py +0 -0
  270. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_vector_store_error_contract.py +0 -0
  271. {fmp_data-2.7.1 → fmp_data-2.9.0}/tests/unit/test_workflow_permission_isolation.py +0 -0
  272. {fmp_data-2.7.1 → 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.7.1
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.4
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.15.4; 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.0; extra == 'dev'
40
- Requires-Dist: nox>=2026.7.11; 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.1; 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.2; extra == 'dev'
49
- Requires-Dist: responses>=0.26.2; extra == 'dev'
49
+ Requires-Dist: pytest>=9.2.0; extra == 'dev'
50
+ Requires-Dist: python-dotenv>=1.2.4; extra == 'dev'
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.2; 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.5; 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.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
- Requires-Dist: tiktoken>=0.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'
72
+ Requires-Dist: tiktoken>=0.14.0; extra == 'langchain'
66
73
  Provides-Extra: mcp
67
- Requires-Dist: mcp[cli]>=2.0.0; extra == 'mcp'
68
- Requires-Dist: pyyaml>=6.0.3; extra == 'mcp'
69
- Requires-Dist: tomli>=2.0.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.7.1'
22
- __version_tuple__ = version_tuple = (2, 7, 1)
21
+ __version__ = version = '2.9.0'
22
+ __version_tuple__ = version_tuple = (2, 9, 0)
23
23
 
24
24
  __commit_id__ = commit_id = None
@@ -105,12 +105,45 @@ class AsyncAlternativeMarketsClient(AsyncEndpointGroup):
105
105
  )
106
106
 
107
107
  async def get_crypto_intraday(
108
- self, symbol: str, interval: Interval = "5min"
108
+ self,
109
+ symbol: str,
110
+ interval: Interval = "5min",
111
+ *,
112
+ start_date: date | None = None,
113
+ end_date: date | None = None,
109
114
  ) -> list[CryptoIntradayPrice]:
110
- """Get cryptocurrency intraday prices"""
115
+ """Get cryptocurrency intraday prices
116
+
117
+ New keyword-only filters are omitted when None, preserving the existing
118
+ request.
119
+
120
+ Args:
121
+ symbol: Ticker symbol identifying the requested instrument.
122
+ interval: Intraday bar interval; defaults to the value in the signature.
123
+ start_date: Start date passed to FMP; boundary semantics depend on the
124
+ endpoint.
125
+ end_date: End date passed to FMP; boundary semantics depend on the
126
+ endpoint.
127
+
128
+ Returns:
129
+ list[CryptoIntradayPrice]: Parsed provider records.
130
+
131
+ Example:
132
+ from datetime import date
133
+ records = await client.alternative.get_crypto_intraday(
134
+ 'BTCUSD', start_date=date(2026, 9, 10)
135
+ )
136
+ """
137
+ optional_params = {
138
+ "start_date": start_date,
139
+ "end_date": end_date,
140
+ }
141
+ optional_params = {
142
+ key: value for key, value in optional_params.items() if value is not None
143
+ }
111
144
  return self._unwrap_list(
112
145
  await self.client.request_async(
113
- CRYPTO_INTRADAY, symbol=symbol, interval=interval
146
+ CRYPTO_INTRADAY, symbol=symbol, interval=interval, **optional_params
114
147
  ),
115
148
  CryptoIntradayPrice,
116
149
  )
@@ -162,12 +195,45 @@ class AsyncAlternativeMarketsClient(AsyncEndpointGroup):
162
195
  )
163
196
 
164
197
  async def get_forex_intraday(
165
- self, symbol: str, interval: Interval = "5min"
198
+ self,
199
+ symbol: str,
200
+ interval: Interval = "5min",
201
+ *,
202
+ start_date: date | None = None,
203
+ end_date: date | None = None,
166
204
  ) -> list[ForexIntradayPrice]:
167
- """Get forex intraday prices"""
205
+ """Get forex intraday prices
206
+
207
+ New keyword-only filters are omitted when None, preserving the existing
208
+ request.
209
+
210
+ Args:
211
+ symbol: Ticker symbol identifying the requested instrument.
212
+ interval: Intraday bar interval; defaults to the value in the signature.
213
+ start_date: Start date passed to FMP; boundary semantics depend on the
214
+ endpoint.
215
+ end_date: End date passed to FMP; boundary semantics depend on the
216
+ endpoint.
217
+
218
+ Returns:
219
+ list[ForexIntradayPrice]: Parsed provider records.
220
+
221
+ Example:
222
+ from datetime import date
223
+ records = await client.alternative.get_forex_intraday(
224
+ 'EURUSD', start_date=date(2026, 9, 10)
225
+ )
226
+ """
227
+ optional_params = {
228
+ "start_date": start_date,
229
+ "end_date": end_date,
230
+ }
231
+ optional_params = {
232
+ key: value for key, value in optional_params.items() if value is not None
233
+ }
168
234
  return self._unwrap_list(
169
235
  await self.client.request_async(
170
- FOREX_INTRADAY, symbol=symbol, interval=interval
236
+ FOREX_INTRADAY, symbol=symbol, interval=interval, **optional_params
171
237
  ),
172
238
  ForexIntradayPrice,
173
239
  )
@@ -221,12 +287,45 @@ class AsyncAlternativeMarketsClient(AsyncEndpointGroup):
221
287
  )
222
288
 
223
289
  async def get_commodity_intraday(
224
- self, symbol: str, interval: Interval = "5min"
290
+ self,
291
+ symbol: str,
292
+ interval: Interval = "5min",
293
+ *,
294
+ start_date: date | None = None,
295
+ end_date: date | None = None,
225
296
  ) -> list[CommodityIntradayPrice]:
226
- """Get commodity intraday prices"""
297
+ """Get commodity intraday prices
298
+
299
+ New keyword-only filters are omitted when None, preserving the existing
300
+ request.
301
+
302
+ Args:
303
+ symbol: Ticker symbol identifying the requested instrument.
304
+ interval: Intraday bar interval; defaults to the value in the signature.
305
+ start_date: Start date passed to FMP; boundary semantics depend on the
306
+ endpoint.
307
+ end_date: End date passed to FMP; boundary semantics depend on the
308
+ endpoint.
309
+
310
+ Returns:
311
+ list[CommodityIntradayPrice]: Parsed provider records.
312
+
313
+ Example:
314
+ from datetime import date
315
+ records = await client.alternative.get_commodity_intraday(
316
+ 'GCUSD', start_date=date(2026, 9, 10)
317
+ )
318
+ """
319
+ optional_params = {
320
+ "start_date": start_date,
321
+ "end_date": end_date,
322
+ }
323
+ optional_params = {
324
+ key: value for key, value in optional_params.items() if value is not None
325
+ }
227
326
  return self._unwrap_list(
228
327
  await self.client.request_async(
229
- COMMODITY_INTRADAY, symbol=symbol, interval=interval
328
+ COMMODITY_INTRADAY, symbol=symbol, interval=interval, **optional_params
230
329
  ),
231
330
  CommodityIntradayPrice,
232
331
  )
@@ -101,11 +101,46 @@ class AlternativeMarketsClient(EndpointGroup):
101
101
  )
102
102
 
103
103
  def get_crypto_intraday(
104
- self, symbol: str, interval: Interval = "5min"
104
+ self,
105
+ symbol: str,
106
+ interval: Interval = "5min",
107
+ *,
108
+ start_date: date | None = None,
109
+ end_date: date | None = None,
105
110
  ) -> list[CryptoIntradayPrice]:
106
- """Get cryptocurrency intraday prices"""
111
+ """Get cryptocurrency intraday prices
112
+
113
+ New keyword-only filters are omitted when None, preserving the existing
114
+ request.
115
+
116
+ Args:
117
+ symbol: Ticker symbol identifying the requested instrument.
118
+ interval: Intraday bar interval; defaults to the value in the signature.
119
+ start_date: Start date passed to FMP; boundary semantics depend on the
120
+ endpoint.
121
+ end_date: End date passed to FMP; boundary semantics depend on the
122
+ endpoint.
123
+
124
+ Returns:
125
+ list[CryptoIntradayPrice]: Parsed provider records.
126
+
127
+ Example:
128
+ from datetime import date
129
+ records = client.alternative.get_crypto_intraday(
130
+ 'BTCUSD', start_date=date(2026, 9, 10)
131
+ )
132
+ """
133
+ optional_params = {
134
+ "start_date": start_date,
135
+ "end_date": end_date,
136
+ }
137
+ optional_params = {
138
+ key: value for key, value in optional_params.items() if value is not None
139
+ }
107
140
  return self._unwrap_list(
108
- self.client.request(CRYPTO_INTRADAY, symbol=symbol, interval=interval),
141
+ self.client.request(
142
+ CRYPTO_INTRADAY, symbol=symbol, interval=interval, **optional_params
143
+ ),
109
144
  CryptoIntradayPrice,
110
145
  )
111
146
 
@@ -156,11 +191,46 @@ class AlternativeMarketsClient(EndpointGroup):
156
191
  )
157
192
 
158
193
  def get_forex_intraday(
159
- self, symbol: str, interval: Interval = "5min"
194
+ self,
195
+ symbol: str,
196
+ interval: Interval = "5min",
197
+ *,
198
+ start_date: date | None = None,
199
+ end_date: date | None = None,
160
200
  ) -> list[ForexIntradayPrice]:
161
- """Get forex intraday prices"""
201
+ """Get forex intraday prices
202
+
203
+ New keyword-only filters are omitted when None, preserving the existing
204
+ request.
205
+
206
+ Args:
207
+ symbol: Ticker symbol identifying the requested instrument.
208
+ interval: Intraday bar interval; defaults to the value in the signature.
209
+ start_date: Start date passed to FMP; boundary semantics depend on the
210
+ endpoint.
211
+ end_date: End date passed to FMP; boundary semantics depend on the
212
+ endpoint.
213
+
214
+ Returns:
215
+ list[ForexIntradayPrice]: Parsed provider records.
216
+
217
+ Example:
218
+ from datetime import date
219
+ records = client.alternative.get_forex_intraday(
220
+ 'EURUSD', start_date=date(2026, 9, 10)
221
+ )
222
+ """
223
+ optional_params = {
224
+ "start_date": start_date,
225
+ "end_date": end_date,
226
+ }
227
+ optional_params = {
228
+ key: value for key, value in optional_params.items() if value is not None
229
+ }
162
230
  return self._unwrap_list(
163
- self.client.request(FOREX_INTRADAY, symbol=symbol, interval=interval),
231
+ self.client.request(
232
+ FOREX_INTRADAY, symbol=symbol, interval=interval, **optional_params
233
+ ),
164
234
  ForexIntradayPrice,
165
235
  )
166
236
 
@@ -211,10 +281,45 @@ class AlternativeMarketsClient(EndpointGroup):
211
281
  )
212
282
 
213
283
  def get_commodity_intraday(
214
- self, symbol: str, interval: Interval = "5min"
284
+ self,
285
+ symbol: str,
286
+ interval: Interval = "5min",
287
+ *,
288
+ start_date: date | None = None,
289
+ end_date: date | None = None,
215
290
  ) -> list[CommodityIntradayPrice]:
216
- """Get commodity intraday prices"""
291
+ """Get commodity intraday prices
292
+
293
+ New keyword-only filters are omitted when None, preserving the existing
294
+ request.
295
+
296
+ Args:
297
+ symbol: Ticker symbol identifying the requested instrument.
298
+ interval: Intraday bar interval; defaults to the value in the signature.
299
+ start_date: Start date passed to FMP; boundary semantics depend on the
300
+ endpoint.
301
+ end_date: End date passed to FMP; boundary semantics depend on the
302
+ endpoint.
303
+
304
+ Returns:
305
+ list[CommodityIntradayPrice]: Parsed provider records.
306
+
307
+ Example:
308
+ from datetime import date
309
+ records = client.alternative.get_commodity_intraday(
310
+ 'GCUSD', start_date=date(2026, 9, 10)
311
+ )
312
+ """
313
+ optional_params = {
314
+ "start_date": start_date,
315
+ "end_date": end_date,
316
+ }
317
+ optional_params = {
318
+ key: value for key, value in optional_params.items() if value is not None
319
+ }
217
320
  return self._unwrap_list(
218
- self.client.request(COMMODITY_INTRADAY, symbol=symbol, interval=interval),
321
+ self.client.request(
322
+ COMMODITY_INTRADAY, symbol=symbol, interval=interval, **optional_params
323
+ ),
219
324
  CommodityIntradayPrice,
220
325
  )
@@ -170,7 +170,26 @@ CRYPTO_INTRADAY: Endpoint[CryptoIntradayPrice] = Endpoint(
170
170
  description="Crypto pair symbol",
171
171
  ),
172
172
  ],
173
- optional_params=[],
173
+ optional_params=[
174
+ EndpointParam(
175
+ name="start_date",
176
+ alias="from",
177
+ location=ParamLocation.QUERY,
178
+ param_type=ParamType.DATE,
179
+ description=(
180
+ "Start date passed to FMP; boundary semantics depend on the endpoint."
181
+ ),
182
+ ),
183
+ EndpointParam(
184
+ name="end_date",
185
+ alias="to",
186
+ location=ParamLocation.QUERY,
187
+ param_type=ParamType.DATE,
188
+ description=(
189
+ "End date passed to FMP; boundary semantics depend on the endpoint."
190
+ ),
191
+ ),
192
+ ],
174
193
  response_model=CryptoIntradayPrice,
175
194
  example_queries=[
176
195
  "Get Bitcoin minute-by-minute prices",
@@ -320,7 +339,26 @@ FOREX_INTRADAY: Endpoint[ForexIntradayPrice] = Endpoint(
320
339
  description="Forex pair symbol",
321
340
  ),
322
341
  ],
323
- optional_params=[],
342
+ optional_params=[
343
+ EndpointParam(
344
+ name="start_date",
345
+ alias="from",
346
+ location=ParamLocation.QUERY,
347
+ param_type=ParamType.DATE,
348
+ description=(
349
+ "Start date passed to FMP; boundary semantics depend on the endpoint."
350
+ ),
351
+ ),
352
+ EndpointParam(
353
+ name="end_date",
354
+ alias="to",
355
+ location=ParamLocation.QUERY,
356
+ param_type=ParamType.DATE,
357
+ description=(
358
+ "End date passed to FMP; boundary semantics depend on the endpoint."
359
+ ),
360
+ ),
361
+ ],
324
362
  response_model=ForexIntradayPrice,
325
363
  example_queries=[
326
364
  "Get minute-by-minute EURUSD data",
@@ -476,7 +514,26 @@ COMMODITY_INTRADAY: Endpoint[CommodityIntradayPrice] = Endpoint(
476
514
  description="Commodity symbol",
477
515
  ),
478
516
  ],
479
- optional_params=[],
517
+ optional_params=[
518
+ EndpointParam(
519
+ name="start_date",
520
+ alias="from",
521
+ location=ParamLocation.QUERY,
522
+ param_type=ParamType.DATE,
523
+ description=(
524
+ "Start date passed to FMP; boundary semantics depend on the endpoint."
525
+ ),
526
+ ),
527
+ EndpointParam(
528
+ name="end_date",
529
+ alias="to",
530
+ location=ParamLocation.QUERY,
531
+ param_type=ParamType.DATE,
532
+ description=(
533
+ "End date passed to FMP; boundary semantics depend on the endpoint."
534
+ ),
535
+ ),
536
+ ],
480
537
  response_model=CommodityIntradayPrice,
481
538
  example_queries=[
482
539
  "Get minute-by-minute gold prices",
@@ -109,7 +109,7 @@ ALTERNATIVE_ENDPOINTS_SEMANTICS = {
109
109
  ],
110
110
  category=SemanticCategory.ALTERNATIVE_DATA,
111
111
  sub_category="Cryptocurrency",
112
- parameter_hints={}, # No parameters needed
112
+ parameter_hints={},
113
113
  response_hints={
114
114
  "symbol": ResponseFieldInfo(
115
115
  description="Trading symbol for the cryptocurrency pair",
@@ -203,7 +203,7 @@ ALTERNATIVE_ENDPOINTS_SEMANTICS = {
203
203
  ],
204
204
  category=SemanticCategory.ALTERNATIVE_DATA,
205
205
  sub_category="Cryptocurrency",
206
- parameter_hints={}, # No parameters needed
206
+ parameter_hints={},
207
207
  response_hints={
208
208
  "price": ResponseFieldInfo(
209
209
  description="Current trading price",
@@ -281,6 +281,8 @@ ALTERNATIVE_ENDPOINTS_SEMANTICS = {
281
281
  parameter_hints={
282
282
  "symbol": SYMBOL_HINTS["crypto"],
283
283
  "interval": INTERVAL_HINT,
284
+ "start_date": DATE_HINTS["start_date"],
285
+ "end_date": DATE_HINTS["end_date"],
284
286
  },
285
287
  response_hints={
286
288
  "datetime": ResponseFieldInfo(
@@ -503,6 +505,8 @@ ALTERNATIVE_ENDPOINTS_SEMANTICS = {
503
505
  parameter_hints={
504
506
  "symbol": SYMBOL_HINTS["forex"],
505
507
  "interval": INTERVAL_HINT,
508
+ "start_date": DATE_HINTS["start_date"],
509
+ "end_date": DATE_HINTS["end_date"],
506
510
  },
507
511
  response_hints={
508
512
  "datetime": ResponseFieldInfo(
@@ -707,6 +711,8 @@ ALTERNATIVE_ENDPOINTS_SEMANTICS = {
707
711
  parameter_hints={
708
712
  "symbol": SYMBOL_HINTS["commodity"],
709
713
  "interval": INTERVAL_HINT,
714
+ "start_date": DATE_HINTS["start_date"],
715
+ "end_date": DATE_HINTS["end_date"],
710
716
  },
711
717
  response_hints={
712
718
  "datetime": ResponseFieldInfo(
@@ -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"