parsimony-finnhub 0.0.1

Finnhub connector for the parsimony framework

parsimony-finnhub

Finnhub source for parsimony: equity quotes, company fundamentals, news, and calendars.

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

Connectors

Group	Connectors
Discovery	finnhub_search
Market data	finnhub_quote
Company	finnhub_profile, finnhub_peers, finnhub_recommendation, finnhub_earnings, finnhub_basic_financials
News	finnhub_company_news, finnhub_market_news
Calendars	finnhub_earnings_calendar, finnhub_ipo_calendar
Enumerator	enumerate_finnhub (full US symbol list)

12 connectors total. Free tier covers all of the above; some adjacent endpoints (/stock/candle, /forex/rates, /stock/splits, /stock/dividend, /stock/price-target) require a paid Finnhub plan and are not exposed here.

Install

pip install parsimony-finnhub

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

export FINNHUB_API_KEY="<your-key>"

Get a key at https://finnhub.io. Free tier: 60 calls/min.

Quick start

import os
from parsimony_finnhub import load

connectors = load(api_key=os.environ["FINNHUB_API_KEY"])
result = connectors["finnhub_quote"](symbol="AAPL")
print(result.data.head())

The API key is declared as a secret (stripped from provenance) and bound off the call surface via load(api_key=...) (or Connector.bind). As a dev fallback it is read from FINNHUB_API_KEY. A missing key raises UnauthorizedError naming the env var.

For multi-plugin composition:

from parsimony import discover
connectors = discover.load_all()

Provider

• Homepage: https://finnhub.io
• API docs: https://finnhub.io/docs/api

License

See LICENSE.