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