parsimony-fmp 0.0.1

Financial Modeling Prep connector for the parsimony framework

parsimony-fmp

Financial Modeling Prep source for parsimony: discovery, quotes, fundamentals, events, signals, and a global equity screener.

Part of the parsimony-connectors monorepo. Distributed standalone on PyPI as parsimony-fmp.

Connectors

Group	Connectors
Discovery	fmp_search, fmp_taxonomy
Core market data	fmp_quotes, fmp_prices
Fundamentals	fmp_company_profile, fmp_peers, fmp_income_statements, fmp_balance_sheet_statements, fmp_cash_flow_statements
Events and catalysts	fmp_corporate_history, fmp_event_calendar, fmp_analyst_estimates
Signals and context	fmp_news, fmp_insider_trades, fmp_institutional_positions, fmp_earnings_transcript
Market context	fmp_index_constituents, fmp_market_movers
Screener	fmp_screener

19 connectors total. Tier coverage is annotated per-connector in the docstrings ([All plans], [Starter+], [Professional+]); the demo plan returns AAPL/TSLA/MSFT only for symbol-bound endpoints.

Status semantics: an invalid key returns 401 → UnauthorizedError; a plan or legacy restriction returns 403 (FMP also uses 402) → PaymentRequiredError. An unknown symbol returns HTTP 200 with [] → EmptyDataError.

Install

pip install parsimony-fmp

Pulls in parsimony-core>=0.7,<0.8 automatically. Verify discovery:

python -c "from parsimony import discover; print([p.name for p in discover.iter_providers()])"

Configuration

The API key is supplied per-call via bind(api_key=...) / load(api_key=...), or — as a dev fallback — from the FMP_API_KEY environment variable:

export FMP_API_KEY="<your-key>"

Get a key at https://financialmodelingprep.com. The key is declared as a secret (secrets=("api_key",)), so it is stripped from recorded provenance and redacted from logs. A missing key fails fast with UnauthorizedError.

Quick start

from parsimony_fmp import load

connectors = load(api_key="<your-key>")   # or rely on FMP_API_KEY
result = connectors["fmp_quotes"](symbols="AAPL,TSLA,MSFT")
print(result.data.head())

For multi-plugin composition:

from parsimony import discover
connectors = discover.load_all()

Provider

• Homepage: https://financialmodelingprep.com
• API docs: https://site.financialmodelingprep.com/developer/docs

License

See LICENSE.