fmp-data 2.4.0__tar.gz → 2.5.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 (206) hide show
  1. {fmp_data-2.4.0 → fmp_data-2.5.0}/PKG-INFO +43 -56
  2. {fmp_data-2.4.0 → fmp_data-2.5.0}/README.md +42 -55
  3. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/company/hints.py +9 -0
  4. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/company/mapping.py +37 -15
  5. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/fundamental/mapping.py +1 -1
  6. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/helpers.py +12 -0
  7. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/institutional/mapping.py +14 -38
  8. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/institutional/models.py +1 -0
  9. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/intelligence/async_client.py +77 -14
  10. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/intelligence/client.py +77 -14
  11. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/intelligence/endpoints.py +33 -3
  12. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/intelligence/mapping.py +438 -105
  13. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/intelligence/models.py +48 -2
  14. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/lc/__init__.py +101 -25
  15. fmp_data-2.5.0/fmp_data/lc/hints.py +134 -0
  16. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/lc/registry.py +63 -32
  17. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/market/mapping.py +23 -12
  18. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/mcp/__main__.py +3 -3
  19. fmp_data-2.5.0/fmp_data/mcp/_compat.py +49 -0
  20. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/mcp/server.py +8 -12
  21. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/mcp/setup.py +3 -4
  22. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/mcp/tool_loader.py +3 -5
  23. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/mcp/tools_manifest.py +16 -7
  24. {fmp_data-2.4.0 → fmp_data-2.5.0}/pyproject.toml +15 -1
  25. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/examples/test_examples_smoke.py +9 -7
  26. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/conftest.py +1 -1
  27. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_economics.py +12 -12
  28. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_intelligence.py +74 -49
  29. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_investment.py +8 -1
  30. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_lc.py +6 -4
  31. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_market.py +9 -9
  32. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/lc/test_mapping.py +9 -2
  33. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/lc/test_models.py +2 -2
  34. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/lc/test_validation_registry.py +70 -0
  35. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/lc/test_vector_store.py +17 -7
  36. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_alternative.py +6 -6
  37. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_async_clients.py +135 -13
  38. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_base.py +6 -2
  39. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_base_async.py +12 -5
  40. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_base_coverage.py +1 -0
  41. fmp_data-2.5.0/tests/unit/test_catalog_registration.py +243 -0
  42. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_client.py +6 -3
  43. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_company.py +5 -2
  44. fmp_data-2.5.0/tests/unit/test_docs_tools_sync.py +149 -0
  45. fmp_data-2.5.0/tests/unit/test_endpoint_registry.py +131 -0
  46. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_exceptions.py +1 -0
  47. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_fundamental.py +1 -0
  48. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_helpers.py +24 -0
  49. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_intelligence.py +168 -48
  50. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_logger.py +5 -1
  51. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_mcp.py +354 -5
  52. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_models.py +3 -1
  53. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_vcr_sanitization.py +3 -4
  54. fmp_data-2.4.0/fmp_data/lc/hints.py +0 -66
  55. {fmp_data-2.4.0 → fmp_data-2.5.0}/.gitignore +0 -0
  56. {fmp_data-2.4.0 → fmp_data-2.5.0}/LICENSE +0 -0
  57. {fmp_data-2.4.0 → fmp_data-2.5.0}/NOTICE +0 -0
  58. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/__init__.py +0 -0
  59. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/alternative/__init__.py +0 -0
  60. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/alternative/async_client.py +0 -0
  61. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/alternative/client.py +0 -0
  62. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/alternative/endpoints.py +0 -0
  63. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/alternative/mapping.py +0 -0
  64. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/alternative/models.py +0 -0
  65. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/alternative/schema.py +0 -0
  66. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/async_client.py +0 -0
  67. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/base.py +0 -0
  68. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/batch/__init__.py +0 -0
  69. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/batch/_csv_utils.py +0 -0
  70. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/batch/async_client.py +0 -0
  71. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/batch/client.py +0 -0
  72. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/batch/endpoints.py +0 -0
  73. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/batch/mapping.py +0 -0
  74. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/batch/models.py +0 -0
  75. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/cache/__init__.py +0 -0
  76. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/cache/base.py +0 -0
  77. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/cache/config.py +0 -0
  78. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/cache/file.py +0 -0
  79. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/cache/memory.py +0 -0
  80. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/cache/redis_backend.py +0 -0
  81. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/client.py +0 -0
  82. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/company/__init__.py +0 -0
  83. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/company/async_client.py +0 -0
  84. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/company/client.py +0 -0
  85. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/company/endpoints.py +0 -0
  86. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/company/models.py +0 -0
  87. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/company/schema.py +0 -0
  88. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/config.py +0 -0
  89. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/economics/__init__.py +0 -0
  90. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/economics/async_client.py +0 -0
  91. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/economics/client.py +0 -0
  92. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/economics/endpoints.py +0 -0
  93. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/economics/mapping.py +0 -0
  94. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/economics/models.py +0 -0
  95. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/economics/schema.py +0 -0
  96. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/exceptions.py +0 -0
  97. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/fundamental/__init__.py +0 -0
  98. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/fundamental/async_client.py +0 -0
  99. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/fundamental/client.py +0 -0
  100. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/fundamental/endpoints.py +0 -0
  101. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/fundamental/models.py +0 -0
  102. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/fundamental/schema.py +0 -0
  103. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/index/__init__.py +0 -0
  104. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/index/async_client.py +0 -0
  105. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/index/client.py +0 -0
  106. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/index/endpoints.py +0 -0
  107. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/index/mapping.py +0 -0
  108. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/index/models.py +0 -0
  109. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/institutional/__init__.py +0 -0
  110. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/institutional/async_client.py +0 -0
  111. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/institutional/client.py +0 -0
  112. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/institutional/endpoints.py +0 -0
  113. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/institutional/schema.py +0 -0
  114. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/intelligence/__init__.py +0 -0
  115. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/intelligence/schema.py +0 -0
  116. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/investment/__init__.py +0 -0
  117. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/investment/async_client.py +0 -0
  118. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/investment/client.py +0 -0
  119. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/investment/endpoints.py +0 -0
  120. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/investment/mapping.py +0 -0
  121. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/investment/models.py +0 -0
  122. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/investment/schema.py +0 -0
  123. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/lc/config.py +0 -0
  124. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/lc/embedding.py +0 -0
  125. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/lc/mapping.py +0 -0
  126. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/lc/models.py +0 -0
  127. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/lc/utils.py +0 -0
  128. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/lc/validation.py +0 -0
  129. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/lc/vector_store.py +0 -0
  130. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/logger.py +0 -0
  131. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/market/__init__.py +0 -0
  132. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/market/async_client.py +0 -0
  133. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/market/client.py +0 -0
  134. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/market/endpoints.py +0 -0
  135. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/market/hints.py +0 -0
  136. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/market/models.py +0 -0
  137. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/market/schema.py +0 -0
  138. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/mcp/__init__.py +0 -0
  139. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/mcp/cli.py +0 -0
  140. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/mcp/discovery.py +0 -0
  141. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/mcp/utils.py +0 -0
  142. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/models.py +0 -0
  143. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/py.typed +0 -0
  144. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/rate_limit.py +0 -0
  145. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/schema.py +0 -0
  146. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/sec/__init__.py +0 -0
  147. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/sec/async_client.py +0 -0
  148. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/sec/client.py +0 -0
  149. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/sec/endpoints.py +0 -0
  150. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/sec/mapping.py +0 -0
  151. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/sec/models.py +0 -0
  152. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/technical/__init__.py +0 -0
  153. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/technical/async_client.py +0 -0
  154. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/technical/client.py +0 -0
  155. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/technical/endpoints.py +0 -0
  156. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/technical/mapping.py +0 -0
  157. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/technical/models.py +0 -0
  158. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/technical/schema.py +0 -0
  159. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/transcripts/__init__.py +0 -0
  160. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/transcripts/async_client.py +0 -0
  161. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/transcripts/client.py +0 -0
  162. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/transcripts/endpoints.py +0 -0
  163. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/transcripts/mapping.py +0 -0
  164. {fmp_data-2.4.0 → fmp_data-2.5.0}/fmp_data/transcripts/models.py +0 -0
  165. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/__init__.py +0 -0
  166. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/examples/__init__.py +0 -0
  167. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/__init__.py +0 -0
  168. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/base.py +0 -0
  169. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_alternative.py +0 -0
  170. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_batch.py +0 -0
  171. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_company.py +0 -0
  172. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_fundamental.py +0 -0
  173. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_index.py +0 -0
  174. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_institutional.py +0 -0
  175. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_sec.py +0 -0
  176. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_technical.py +0 -0
  177. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/integration/test_transcripts.py +0 -0
  178. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/__init__.py +0 -0
  179. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/conftest.py +0 -0
  180. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/lc/__init__.py +0 -0
  181. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/lc/conftest.py +0 -0
  182. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/lc/test_config.py +0 -0
  183. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/lc/test_embedding.py +0 -0
  184. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/lc/test_endpoint_based_rules.py +0 -0
  185. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/lc/test_imports.py +0 -0
  186. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/lc/test_utils.py +0 -0
  187. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_alternative_coverage.py +0 -0
  188. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_batch.py +0 -0
  189. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_cache_backends.py +0 -0
  190. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_cache_integration.py +0 -0
  191. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_cassette_contracts.py +0 -0
  192. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_company_coverage.py +0 -0
  193. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_config.py +0 -0
  194. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_economics.py +0 -0
  195. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_index.py +0 -0
  196. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_institutional.py +0 -0
  197. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_investment.py +0 -0
  198. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_market.py +0 -0
  199. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_mcp_cli.py +0 -0
  200. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_rate_limit.py +0 -0
  201. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_rate_limit_async.py +0 -0
  202. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_rate_limit_coverage.py +0 -0
  203. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_sec.py +0 -0
  204. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_technical.py +0 -0
  205. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_technical_coverage.py +0 -0
  206. {fmp_data-2.4.0 → fmp_data-2.5.0}/tests/unit/test_transcripts.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: fmp-data
3
- Version: 2.4.0
3
+ Version: 2.5.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
@@ -297,15 +297,15 @@ from fmp_data import create_vector_store
297
297
 
298
298
  # Initialize the vector store
299
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
300
+ fmp_api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
301
+ openai_api_key="YOUR_OPENAI_API_KEY", # pragma: allowlist secret
302
302
  )
303
303
 
304
304
  # Example queries
305
305
  queries = [
306
306
  "what is the price of Apple stock?",
307
307
  "what was the revenue of Tesla last year?",
308
- "what's new in the market?"
308
+ "what's new in the market?",
309
309
  ]
310
310
 
311
311
  # Search for relevant endpoints and tools
@@ -319,7 +319,7 @@ for query in queries:
319
319
  for tool in tools:
320
320
  print(f"Name: {tool.get('name')}")
321
321
  print(f"Description: {tool.get('description')}")
322
- print("Parameters:", tool.get('parameters'))
322
+ print("Parameters:", tool.get("parameters"))
323
323
  print()
324
324
 
325
325
  # You can also search endpoints directly
@@ -346,10 +346,10 @@ from fmp_data.lc.embedding import EmbeddingProvider
346
346
 
347
347
  # Configure with LangChain support
348
348
  config = LangChainConfig(
349
- api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
349
+ api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
350
350
  embedding_provider=EmbeddingProvider.OPENAI,
351
- embedding_api_key="YOUR_OPENAI_API_KEY", # pragma: allowlist secret
352
- embedding_model="text-embedding-3-small"
351
+ embedding_api_key="YOUR_OPENAI_API_KEY", # pragma: allowlist secret
352
+ embedding_model="text-embedding-3-small",
353
353
  )
354
354
 
355
355
  # Create client with LangChain config
@@ -398,23 +398,23 @@ from fmp_data import FMPDataClient, ClientConfig, LoggingConfig
398
398
  from fmp_data.exceptions import FMPError, RateLimitError, AuthenticationError
399
399
 
400
400
  # Method 1: Initialize with direct API key
401
- client = FMPDataClient(api_key="your_api_key_here") # pragma: allowlist secret
401
+ client = FMPDataClient(api_key="your_api_key_here") # pragma: allowlist secret
402
402
 
403
403
  # Method 2: Initialize from environment variable (FMP_API_KEY)
404
404
  client = FMPDataClient.from_env()
405
405
 
406
406
  # Method 3: Initialize with custom configuration
407
407
  config = ClientConfig(
408
- api_key="your_api_key_here", #pragma: allowlist secret
408
+ api_key="your_api_key_here", # pragma: allowlist secret
409
409
  timeout=30,
410
410
  max_retries=3,
411
411
  base_url="https://financialmodelingprep.com",
412
- logging=LoggingConfig(level="INFO")
412
+ logging=LoggingConfig(level="INFO"),
413
413
  )
414
414
  client = FMPDataClient(config=config)
415
415
 
416
416
  # Using with context manager (recommended)
417
- with FMPDataClient(api_key="your_api_key_here") as client: # pragma: allowlist secret
417
+ with FMPDataClient(api_key="your_api_key_here") as client: # pragma: allowlist secret
418
418
  try:
419
419
  # Get company profile
420
420
  profile = client.company.get_profile("AAPL")
@@ -492,14 +492,11 @@ with FMPDataClient.from_env() as client:
492
492
  income_stmt = client.fundamental.get_income_statement(
493
493
  "AAPL",
494
494
  period="quarter", # or "annual"
495
- limit=4
495
+ limit=4,
496
496
  )
497
497
 
498
498
  # Get balance sheets
499
- balance_sheet = client.fundamental.get_balance_sheet(
500
- "AAPL",
501
- period="annual"
502
- )
499
+ balance_sheet = client.fundamental.get_balance_sheet("AAPL", period="annual")
503
500
 
504
501
  # Get cash flow statements
505
502
  cash_flow = client.fundamental.get_cash_flow("AAPL")
@@ -515,16 +512,11 @@ with FMPDataClient.from_env() as client:
515
512
 
516
513
  # Get historical prices
517
514
  history = client.company.get_historical_prices(
518
- symbol="TSLA",
519
- from_date=date(2023, 1, 1),
520
- to_date=date(2023, 12, 31)
515
+ symbol="TSLA", from_date=date(2023, 1, 1), to_date=date(2023, 12, 31)
521
516
  )
522
517
 
523
518
  # Get intraday prices
524
- intraday = client.company.get_intraday_prices(
525
- "TSLA",
526
- interval="5min"
527
- )
519
+ intraday = client.company.get_intraday_prices("TSLA", interval="5min")
528
520
  ```
529
521
 
530
522
  ### 4. Technical Indicators
@@ -534,25 +526,14 @@ from datetime import date
534
526
 
535
527
  with FMPDataClient.from_env() as client:
536
528
  # Simple Moving Average
537
- sma = client.technical.get_sma(
538
- "AAPL",
539
- period_length=20,
540
- timeframe="1day"
541
- )
529
+ sma = client.technical.get_sma("AAPL", period_length=20, timeframe="1day")
542
530
 
543
531
  # RSI (Relative Strength Index)
544
- rsi = client.technical.get_rsi(
545
- "AAPL",
546
- period_length=14,
547
- timeframe="1day"
548
- )
532
+ rsi = client.technical.get_rsi("AAPL", period_length=14, timeframe="1day")
549
533
 
550
534
  # MACD
551
535
  macd = client.technical.get_macd(
552
- "AAPL",
553
- fast_period=12,
554
- slow_period=26,
555
- signal_period=9
536
+ "AAPL", fast_period=12, slow_period=26, signal_period=9
556
537
  )
557
538
  ```
558
539
 
@@ -668,6 +649,7 @@ API reference in `docs/api/reference.md#async-client-usage`.
668
649
  from fmp_data import AsyncFMPDataClient
669
650
  import asyncio
670
651
 
652
+
671
653
  async def main():
672
654
  async with AsyncFMPDataClient.from_env() as client:
673
655
  # All endpoint methods are async
@@ -683,6 +665,7 @@ async def main():
683
665
  for p in profiles:
684
666
  print(f"{p.symbol}: {p.company_name}")
685
667
 
668
+
686
669
  asyncio.run(main())
687
670
  ```
688
671
 
@@ -715,7 +698,13 @@ FMP_MCP_MANIFEST=/path/to/custom/manifest.py
715
698
 
716
699
  ### Custom Configuration
717
700
  ```python
718
- from fmp_data import FMPDataClient, ClientConfig, LoggingConfig, RateLimitConfig, LogHandlerConfig
701
+ from fmp_data import (
702
+ FMPDataClient,
703
+ ClientConfig,
704
+ LoggingConfig,
705
+ RateLimitConfig,
706
+ LogHandlerConfig,
707
+ )
719
708
 
720
709
  config = ClientConfig(
721
710
  api_key="your_api_key_here", # pragma: allowlist secret
@@ -723,9 +712,7 @@ config = ClientConfig(
723
712
  max_retries=3,
724
713
  base_url="https://financialmodelingprep.com",
725
714
  rate_limit=RateLimitConfig(
726
- daily_limit=250,
727
- requests_per_second=10,
728
- requests_per_minute=300
715
+ daily_limit=250, requests_per_second=10, requests_per_minute=300
729
716
  ),
730
717
  logging=LoggingConfig(
731
718
  level="DEBUG",
@@ -733,7 +720,7 @@ config = ClientConfig(
733
720
  "console": LogHandlerConfig(
734
721
  class_name="StreamHandler",
735
722
  level="INFO",
736
- format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
723
+ format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
737
724
  ),
738
725
  "file": LogHandlerConfig(
739
726
  class_name="RotatingFileHandler",
@@ -742,11 +729,11 @@ config = ClientConfig(
742
729
  handler_kwargs={
743
730
  "filename": "fmp.log",
744
731
  "maxBytes": 10485760,
745
- "backupCount": 5
746
- }
747
- )
748
- }
749
- )
732
+ "backupCount": 5,
733
+ },
734
+ ),
735
+ },
736
+ ),
750
737
  )
751
738
 
752
739
  client = FMPDataClient(config=config)
@@ -759,15 +746,15 @@ The library provides a comprehensive exception hierarchy for robust error handli
759
746
  ```python
760
747
  from fmp_data import FMPDataClient
761
748
  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
749
+ FMPError, # Base exception for all FMP errors
750
+ RateLimitError, # API rate limit exceeded
751
+ AuthenticationError, # Invalid or missing API key
752
+ ValidationError, # Invalid request parameters
753
+ ConfigError, # Configuration errors
754
+ InvalidSymbolError, # Missing or blank required symbol
768
755
  InvalidResponseTypeError, # Unexpected API response type
769
- DependencyError, # Missing optional dependency
770
- FMPNotFound, # Symbol or resource not found
756
+ DependencyError, # Missing optional dependency
757
+ FMPNotFound, # Symbol or resource not found
771
758
  )
772
759
 
773
760
  try:
@@ -227,15 +227,15 @@ from fmp_data import create_vector_store
227
227
 
228
228
  # Initialize the vector store
229
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
230
+ fmp_api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
231
+ openai_api_key="YOUR_OPENAI_API_KEY", # pragma: allowlist secret
232
232
  )
233
233
 
234
234
  # Example queries
235
235
  queries = [
236
236
  "what is the price of Apple stock?",
237
237
  "what was the revenue of Tesla last year?",
238
- "what's new in the market?"
238
+ "what's new in the market?",
239
239
  ]
240
240
 
241
241
  # Search for relevant endpoints and tools
@@ -249,7 +249,7 @@ for query in queries:
249
249
  for tool in tools:
250
250
  print(f"Name: {tool.get('name')}")
251
251
  print(f"Description: {tool.get('description')}")
252
- print("Parameters:", tool.get('parameters'))
252
+ print("Parameters:", tool.get("parameters"))
253
253
  print()
254
254
 
255
255
  # You can also search endpoints directly
@@ -276,10 +276,10 @@ from fmp_data.lc.embedding import EmbeddingProvider
276
276
 
277
277
  # Configure with LangChain support
278
278
  config = LangChainConfig(
279
- api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
279
+ api_key="YOUR_FMP_API_KEY", # pragma: allowlist secret
280
280
  embedding_provider=EmbeddingProvider.OPENAI,
281
- embedding_api_key="YOUR_OPENAI_API_KEY", # pragma: allowlist secret
282
- embedding_model="text-embedding-3-small"
281
+ embedding_api_key="YOUR_OPENAI_API_KEY", # pragma: allowlist secret
282
+ embedding_model="text-embedding-3-small",
283
283
  )
284
284
 
285
285
  # Create client with LangChain config
@@ -328,23 +328,23 @@ from fmp_data import FMPDataClient, ClientConfig, LoggingConfig
328
328
  from fmp_data.exceptions import FMPError, RateLimitError, AuthenticationError
329
329
 
330
330
  # Method 1: Initialize with direct API key
331
- client = FMPDataClient(api_key="your_api_key_here") # pragma: allowlist secret
331
+ client = FMPDataClient(api_key="your_api_key_here") # pragma: allowlist secret
332
332
 
333
333
  # Method 2: Initialize from environment variable (FMP_API_KEY)
334
334
  client = FMPDataClient.from_env()
335
335
 
336
336
  # Method 3: Initialize with custom configuration
337
337
  config = ClientConfig(
338
- api_key="your_api_key_here", #pragma: allowlist secret
338
+ api_key="your_api_key_here", # pragma: allowlist secret
339
339
  timeout=30,
340
340
  max_retries=3,
341
341
  base_url="https://financialmodelingprep.com",
342
- logging=LoggingConfig(level="INFO")
342
+ logging=LoggingConfig(level="INFO"),
343
343
  )
344
344
  client = FMPDataClient(config=config)
345
345
 
346
346
  # Using with context manager (recommended)
347
- with FMPDataClient(api_key="your_api_key_here") as client: # pragma: allowlist secret
347
+ with FMPDataClient(api_key="your_api_key_here") as client: # pragma: allowlist secret
348
348
  try:
349
349
  # Get company profile
350
350
  profile = client.company.get_profile("AAPL")
@@ -422,14 +422,11 @@ with FMPDataClient.from_env() as client:
422
422
  income_stmt = client.fundamental.get_income_statement(
423
423
  "AAPL",
424
424
  period="quarter", # or "annual"
425
- limit=4
425
+ limit=4,
426
426
  )
427
427
 
428
428
  # Get balance sheets
429
- balance_sheet = client.fundamental.get_balance_sheet(
430
- "AAPL",
431
- period="annual"
432
- )
429
+ balance_sheet = client.fundamental.get_balance_sheet("AAPL", period="annual")
433
430
 
434
431
  # Get cash flow statements
435
432
  cash_flow = client.fundamental.get_cash_flow("AAPL")
@@ -445,16 +442,11 @@ with FMPDataClient.from_env() as client:
445
442
 
446
443
  # Get historical prices
447
444
  history = client.company.get_historical_prices(
448
- symbol="TSLA",
449
- from_date=date(2023, 1, 1),
450
- to_date=date(2023, 12, 31)
445
+ symbol="TSLA", from_date=date(2023, 1, 1), to_date=date(2023, 12, 31)
451
446
  )
452
447
 
453
448
  # Get intraday prices
454
- intraday = client.company.get_intraday_prices(
455
- "TSLA",
456
- interval="5min"
457
- )
449
+ intraday = client.company.get_intraday_prices("TSLA", interval="5min")
458
450
  ```
459
451
 
460
452
  ### 4. Technical Indicators
@@ -464,25 +456,14 @@ from datetime import date
464
456
 
465
457
  with FMPDataClient.from_env() as client:
466
458
  # Simple Moving Average
467
- sma = client.technical.get_sma(
468
- "AAPL",
469
- period_length=20,
470
- timeframe="1day"
471
- )
459
+ sma = client.technical.get_sma("AAPL", period_length=20, timeframe="1day")
472
460
 
473
461
  # RSI (Relative Strength Index)
474
- rsi = client.technical.get_rsi(
475
- "AAPL",
476
- period_length=14,
477
- timeframe="1day"
478
- )
462
+ rsi = client.technical.get_rsi("AAPL", period_length=14, timeframe="1day")
479
463
 
480
464
  # MACD
481
465
  macd = client.technical.get_macd(
482
- "AAPL",
483
- fast_period=12,
484
- slow_period=26,
485
- signal_period=9
466
+ "AAPL", fast_period=12, slow_period=26, signal_period=9
486
467
  )
487
468
  ```
488
469
 
@@ -598,6 +579,7 @@ API reference in `docs/api/reference.md#async-client-usage`.
598
579
  from fmp_data import AsyncFMPDataClient
599
580
  import asyncio
600
581
 
582
+
601
583
  async def main():
602
584
  async with AsyncFMPDataClient.from_env() as client:
603
585
  # All endpoint methods are async
@@ -613,6 +595,7 @@ async def main():
613
595
  for p in profiles:
614
596
  print(f"{p.symbol}: {p.company_name}")
615
597
 
598
+
616
599
  asyncio.run(main())
617
600
  ```
618
601
 
@@ -645,7 +628,13 @@ FMP_MCP_MANIFEST=/path/to/custom/manifest.py
645
628
 
646
629
  ### Custom Configuration
647
630
  ```python
648
- from fmp_data import FMPDataClient, ClientConfig, LoggingConfig, RateLimitConfig, LogHandlerConfig
631
+ from fmp_data import (
632
+ FMPDataClient,
633
+ ClientConfig,
634
+ LoggingConfig,
635
+ RateLimitConfig,
636
+ LogHandlerConfig,
637
+ )
649
638
 
650
639
  config = ClientConfig(
651
640
  api_key="your_api_key_here", # pragma: allowlist secret
@@ -653,9 +642,7 @@ config = ClientConfig(
653
642
  max_retries=3,
654
643
  base_url="https://financialmodelingprep.com",
655
644
  rate_limit=RateLimitConfig(
656
- daily_limit=250,
657
- requests_per_second=10,
658
- requests_per_minute=300
645
+ daily_limit=250, requests_per_second=10, requests_per_minute=300
659
646
  ),
660
647
  logging=LoggingConfig(
661
648
  level="DEBUG",
@@ -663,7 +650,7 @@ config = ClientConfig(
663
650
  "console": LogHandlerConfig(
664
651
  class_name="StreamHandler",
665
652
  level="INFO",
666
- format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
653
+ format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
667
654
  ),
668
655
  "file": LogHandlerConfig(
669
656
  class_name="RotatingFileHandler",
@@ -672,11 +659,11 @@ config = ClientConfig(
672
659
  handler_kwargs={
673
660
  "filename": "fmp.log",
674
661
  "maxBytes": 10485760,
675
- "backupCount": 5
676
- }
677
- )
678
- }
679
- )
662
+ "backupCount": 5,
663
+ },
664
+ ),
665
+ },
666
+ ),
680
667
  )
681
668
 
682
669
  client = FMPDataClient(config=config)
@@ -689,15 +676,15 @@ The library provides a comprehensive exception hierarchy for robust error handli
689
676
  ```python
690
677
  from fmp_data import FMPDataClient
691
678
  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
679
+ FMPError, # Base exception for all FMP errors
680
+ RateLimitError, # API rate limit exceeded
681
+ AuthenticationError, # Invalid or missing API key
682
+ ValidationError, # Invalid request parameters
683
+ ConfigError, # Configuration errors
684
+ InvalidSymbolError, # Missing or blank required symbol
698
685
  InvalidResponseTypeError, # Unexpected API response type
699
- DependencyError, # Missing optional dependency
700
- FMPNotFound, # Symbol or resource not found
686
+ DependencyError, # Missing optional dependency
687
+ FMPNotFound, # Symbol or resource not found
701
688
  )
702
689
 
703
690
  try:
@@ -77,6 +77,15 @@ FLOAT_RESPONSE_HINTS = {
77
77
  ),
78
78
  }
79
79
 
80
+ NONADJUSTED_HINT = ParameterHint(
81
+ natural_names=["nonadjusted", "unadjusted", "raw prices"],
82
+ extraction_patterns=[
83
+ r"(?i)\b(non-?adjusted|unadjusted|raw)\b",
84
+ ],
85
+ examples=["true", "false"],
86
+ context_clues=["nonadjusted", "unadjusted", "raw", "without adjustments"],
87
+ )
88
+
80
89
  INTERVAL_HINT = ParameterHint(
81
90
  natural_names=["interval", "timeframe", "period"],
82
91
  extraction_patterns=[
@@ -35,10 +35,17 @@ from fmp_data.company.hints import (
35
35
  CIK_HINT,
36
36
  FLOAT_RESPONSE_HINTS,
37
37
  INTERVAL_HINT,
38
+ NONADJUSTED_HINT,
38
39
  PROFILE_RESPONSE_HINTS,
39
40
  STRUCTURE_HINT,
40
41
  )
41
- from fmp_data.lc.hints import DATE_HINTS, PERIOD_HINT, SYMBOL_HINT
42
+ from fmp_data.lc.hints import (
43
+ DATE_HINTS,
44
+ LIMIT_HINT,
45
+ PAGE_HINT,
46
+ PERIOD_HINT,
47
+ SYMBOL_HINT,
48
+ )
42
49
  from fmp_data.lc.models import EndpointSemantics, ResponseFieldInfo, SemanticCategory
43
50
 
44
51
  # Company endpoints mapping
@@ -283,7 +290,11 @@ COMPANY_ENDPOINTS_SEMANTICS = {
283
290
  ],
284
291
  category=SemanticCategory.COMPANY_INFO,
285
292
  sub_category="Revenue",
286
- parameter_hints={"symbol": SYMBOL_HINT, "structure": STRUCTURE_HINT},
293
+ parameter_hints={
294
+ "symbol": SYMBOL_HINT,
295
+ "structure": STRUCTURE_HINT,
296
+ "period": PERIOD_HINT,
297
+ },
287
298
  response_hints={
288
299
  "segments": ResponseFieldInfo(
289
300
  description="Revenue by region",
@@ -414,7 +425,7 @@ COMPANY_ENDPOINTS_SEMANTICS = {
414
425
  "employment figures",
415
426
  ],
416
427
  category=SemanticCategory.COMPANY_INFO,
417
- parameter_hints={"symbol": SYMBOL_HINT},
428
+ parameter_hints={"symbol": SYMBOL_HINT, "limit": LIMIT_HINT},
418
429
  response_hints={
419
430
  "count": ResponseFieldInfo(
420
431
  description="Number of employees",
@@ -655,7 +666,7 @@ COMPANY_ENDPOINTS_SEMANTICS = {
655
666
  ],
656
667
  ),
657
668
  "quote": EndpointSemantics(
658
- client_name="market",
669
+ client_name="company",
659
670
  method_name="get_quote",
660
671
  natural_description=(
661
672
  "Get real-time stock quote data including current price, "
@@ -705,7 +716,7 @@ COMPANY_ENDPOINTS_SEMANTICS = {
705
716
  ],
706
717
  ),
707
718
  "simple_quote": EndpointSemantics(
708
- client_name="market",
719
+ client_name="company",
709
720
  method_name="get_simple_quote",
710
721
  natural_description=(
711
722
  "Get real-time basic stock quote "
@@ -773,7 +784,7 @@ COMPANY_ENDPOINTS_SEMANTICS = {
773
784
  "post-market trade",
774
785
  "extended hours trade",
775
786
  ],
776
- category=SemanticCategory.MARKET_DATA,
787
+ category=SemanticCategory.COMPANY_INFO,
777
788
  sub_category="Aftermarket Data",
778
789
  parameter_hints={"symbol": SYMBOL_HINT},
779
790
  response_hints={
@@ -819,7 +830,7 @@ COMPANY_ENDPOINTS_SEMANTICS = {
819
830
  "post-market quote",
820
831
  "extended hours quote",
821
832
  ],
822
- category=SemanticCategory.MARKET_DATA,
833
+ category=SemanticCategory.COMPANY_INFO,
823
834
  sub_category="Aftermarket Data",
824
835
  parameter_hints={"symbol": SYMBOL_HINT},
825
836
  response_hints={
@@ -869,7 +880,7 @@ COMPANY_ENDPOINTS_SEMANTICS = {
869
880
  "return",
870
881
  "timeframe change",
871
882
  ],
872
- category=SemanticCategory.MARKET_DATA,
883
+ category=SemanticCategory.COMPANY_INFO,
873
884
  sub_category="Price Performance",
874
885
  parameter_hints={"symbol": SYMBOL_HINT},
875
886
  response_hints={
@@ -896,7 +907,7 @@ COMPANY_ENDPOINTS_SEMANTICS = {
896
907
  ],
897
908
  ),
898
909
  "intraday_prices": EndpointSemantics(
899
- client_name="market",
910
+ client_name="company",
900
911
  method_name="get_intraday_prices",
901
912
  natural_description=(
902
913
  "Get intraday price data with minute-by-minute or hourly intervals"
@@ -920,6 +931,9 @@ COMPANY_ENDPOINTS_SEMANTICS = {
920
931
  parameter_hints={
921
932
  "symbol": SYMBOL_HINT,
922
933
  "interval": INTERVAL_HINT,
934
+ "start_date": DATE_HINTS["start_date"],
935
+ "end_date": DATE_HINTS["end_date"],
936
+ "nonadjusted": NONADJUSTED_HINT,
923
937
  },
924
938
  response_hints={
925
939
  "datetime": ResponseFieldInfo(
@@ -941,7 +955,7 @@ COMPANY_ENDPOINTS_SEMANTICS = {
941
955
  ],
942
956
  ),
943
957
  "historical_price": EndpointSemantics(
944
- client_name="market",
958
+ client_name="company",
945
959
  method_name="get_historical_prices",
946
960
  natural_description=(
947
961
  "Retrieve historical daily price data including open, high, low, close, "
@@ -1012,7 +1026,7 @@ COMPANY_ENDPOINTS_SEMANTICS = {
1012
1026
  ],
1013
1027
  ),
1014
1028
  "intraday_price": EndpointSemantics(
1015
- client_name="market",
1029
+ client_name="company",
1016
1030
  method_name="get_intraday_prices",
1017
1031
  natural_description=(
1018
1032
  "Get intraday price data at various intervals (1min to 4hour) "
@@ -1038,6 +1052,9 @@ COMPANY_ENDPOINTS_SEMANTICS = {
1038
1052
  parameter_hints={
1039
1053
  "symbol": SYMBOL_HINT,
1040
1054
  "interval": INTERVAL_HINT,
1055
+ "start_date": DATE_HINTS["start_date"],
1056
+ "end_date": DATE_HINTS["end_date"],
1057
+ "nonadjusted": NONADJUSTED_HINT,
1041
1058
  },
1042
1059
  response_hints={
1043
1060
  "date": ResponseFieldInfo(
@@ -1066,7 +1083,7 @@ COMPANY_ENDPOINTS_SEMANTICS = {
1066
1083
  ],
1067
1084
  ),
1068
1085
  "market_cap": EndpointSemantics(
1069
- client_name="market",
1086
+ client_name="company",
1070
1087
  method_name="get_market_cap",
1071
1088
  natural_description=(
1072
1089
  "Get current market capitalization data for a company, including "
@@ -1106,7 +1123,7 @@ COMPANY_ENDPOINTS_SEMANTICS = {
1106
1123
  ],
1107
1124
  ),
1108
1125
  "historical_market_cap": EndpointSemantics(
1109
- client_name="market",
1126
+ client_name="company",
1110
1127
  method_name="get_historical_market_cap",
1111
1128
  natural_description=(
1112
1129
  "Retrieve historical market capitalization data to track changes in "
@@ -1150,7 +1167,7 @@ COMPANY_ENDPOINTS_SEMANTICS = {
1150
1167
  ],
1151
1168
  ),
1152
1169
  "historical_prices": EndpointSemantics(
1153
- client_name="market",
1170
+ client_name="company",
1154
1171
  method_name="get_historical_prices",
1155
1172
  natural_description=(
1156
1173
  "Retrieve historical price data including OHLCV (Open, High, Low, Close, "
@@ -1270,7 +1287,12 @@ COMPANY_ENDPOINTS_SEMANTICS = {
1270
1287
  ],
1271
1288
  category=SemanticCategory.COMPANY_INFO,
1272
1289
  sub_category="Analyst Research",
1273
- parameter_hints={"symbol": SYMBOL_HINT},
1290
+ parameter_hints={
1291
+ "symbol": SYMBOL_HINT,
1292
+ "period": PERIOD_HINT,
1293
+ "page": PAGE_HINT,
1294
+ "limit": LIMIT_HINT,
1295
+ },
1274
1296
  response_hints={
1275
1297
  "estimated_revenue_avg": ResponseFieldInfo(
1276
1298
  description="Average estimated revenue",
@@ -572,7 +572,7 @@ FUNDAMENTAL_ENDPOINTS_SEMANTICS = {
572
572
  ],
573
573
  category=SemanticCategory.FUNDAMENTAL_ANALYSIS,
574
574
  sub_category="Financial Metrics",
575
- parameter_hints={"symbol": SYMBOL_HINT},
575
+ parameter_hints={"symbol": SYMBOL_HINT, "limit": LIMIT_HINT},
576
576
  response_hints={
577
577
  "reported_owner_earnings": ResponseFieldInfo(
578
578
  description="Reported owner earnings value",
@@ -1,6 +1,7 @@
1
1
  # src/helpers.py
2
2
  from collections.abc import Callable
3
3
  import functools
4
+ import inspect
4
5
  from typing import Any, TypeVar
5
6
  import warnings
6
7
 
@@ -18,6 +19,8 @@ def deprecated(reason: str = "") -> Callable[[F], F]:
18
19
 
19
20
  Returns:
20
21
  A decorator that emits a DeprecationWarning when the function is called.
22
+ Coroutine functions are wrapped with an async wrapper so
23
+ ``inspect.iscoroutinefunction`` remains True.
21
24
 
22
25
  Example:
23
26
  >>> @deprecated("Use `new_method` instead.")
@@ -30,6 +33,15 @@ def deprecated(reason: str = "") -> Callable[[F], F]:
30
33
  if reason:
31
34
  msg += f" {reason}"
32
35
 
36
+ if inspect.iscoroutinefunction(func):
37
+
38
+ @functools.wraps(func)
39
+ async def async_wrapped(*args: Any, **kwargs: Any) -> Any:
40
+ warnings.warn(msg, category=DeprecationWarning, stacklevel=2)
41
+ return await func(*args, **kwargs)
42
+
43
+ return async_wrapped # type: ignore[return-value]
44
+
33
45
  @functools.wraps(func)
34
46
  def wrapped(*args: Any, **kwargs: Any) -> Any:
35
47
  warnings.warn(msg, category=DeprecationWarning, stacklevel=2)