Skip to main content

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 a compatible parsimony 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.raw.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

License

See LICENSE.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

parsimony_finnhub-0.0.2.tar.gz (14.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

parsimony_finnhub-0.0.2-py3-none-any.whl (15.6 kB view details)

Uploaded Python 3

File details

Details for the file parsimony_finnhub-0.0.2.tar.gz.

File metadata

  • Download URL: parsimony_finnhub-0.0.2.tar.gz
  • Upload date:
  • Size: 14.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for parsimony_finnhub-0.0.2.tar.gz
Algorithm Hash digest
SHA256 c2db43444fb502beaca7f7ad33ed6be865cbe0dae681be63b1ed625b35b7cdf3
MD5 d37d4a4eb566ad890930908426bb4b88
BLAKE2b-256 03820bd3156ac47cc5c81faa5b46e40c594aa54e240bf49c09f928d7d45cdff6

See more details on using hashes here.

Provenance

The following attestation bundles were made for parsimony_finnhub-0.0.2.tar.gz:

Publisher: release.yml on ockham-sh/parsimony-connectors

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file parsimony_finnhub-0.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for parsimony_finnhub-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 353220308d9d1093ac0415999bffa0127e694f8571af6b8e3dd7bb4e87524833
MD5 15d6887b18b81d8e08483c4ae52f933f
BLAKE2b-256 d5800ee7ea3375a8753ac83b86fd492dca927d89eea5f4fcd2f06dea304d51c8

See more details on using hashes here.

Provenance

The following attestation bundles were made for parsimony_finnhub-0.0.2-py3-none-any.whl:

Publisher: release.yml on ockham-sh/parsimony-connectors

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.0.2 This release

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page