Overview

**Ready-made connectors for financial and economic data, built on [parsimony](https://github.com/ockham-sh/parsimony).** [](https://opensource.org/licenses/Apache-2.0) [](https://github.com/ockham-sh/parsimony-connectors/blob/main/pyproject.toml) [](https://github.com/ockham-sh/parsimony-connectors/actions)

---

This repository holds connectors for 22 sources of financial and economic data: central banks, statistical offices, and market data vendors. Each source is its own pip package. Install the ones you need and parsimony picks them up automatically. The parsimony agent skill teaches coding agents to work with them.

Quickstart

pip install parsimony-fred

from parsimony_fred import CONNECTORS

fred = CONNECTORS.bind(api_key="...")
print(fred.describe())

result = fred["fred_fetch"](series_id="UNRATE")
print(result.frame.tail())   # tabular results expose .frame

Instead of bind, you can set the FRED_API_KEY environment variable. More in credentials.

Search comes first

Getting data is two steps: search for the series you want, then fetch it by the ID the search returned. Every package ships both kinds of connectors. Where the provider has a search API, the search connector calls it directly. Where the provider can only list its contents, we build a search catalog with parsimony's catalog tooling and publish it on Hugging Face; the catalog downloads and caches locally the first time you search.

Available connectors

	Package	Source	Connectors
	parsimony-alpha-vantage	Alpha Vantage	29
	parsimony-bde	Banco de España	3
	parsimony-bdf	Banque de France	3
	parsimony-bdp	Banco de Portugal	3
	parsimony-bls	U.S. Bureau of Labor Statistics	5
	parsimony-boc	Bank of Canada	3
	parsimony-boj	Bank of Japan	4
	parsimony-coingecko	CoinGecko	11
	parsimony-destatis	Destatis (German federal statistics)	3
	parsimony-eia	U.S. Energy Information Administration	5
	parsimony-eodhd	EODHD	17
	parsimony-finnhub	Finnhub	12
	parsimony-fmp	Financial Modeling Prep	19
	parsimony-fred	FRED (Federal Reserve Economic Data)	2
	parsimony-polymarket	Polymarket	4
	parsimony-rba	Reserve Bank of Australia	3
	parsimony-riksbank	Sveriges Riksbank (SWEA, SWESTR, Monetary Policy, Turnover, Holdings)	7
	parsimony-sdmx	SDMX protocol (ECB, Eurostat, IMF, World Bank)	4
	parsimony-sec-edgar	SEC EDGAR	12
	parsimony-snb	Swiss National Bank (SNB)	3
	parsimony-tiingo	Tiingo	13
	parsimony-treasury	U.S. Treasury (Fiscal Data + Office of Debt Management rate feeds)	4

The table is generated from the package metadata. Run make readme-roster to refresh it.

Adding a connector

A connector is a small package under packages/. Start with the authoring guide and CONTRIBUTING.md. GOVERNANCE.md covers what we accept and how packages are maintained.

Documentation

• Getting started
• Connectors
• Discovery and catalogs
• Credentials
• CLI reference

The complete documentation is published at docs.parsimony.dev.

Related projects

• parsimony is the framework these connectors are built on.
• parsimony-agents is a ready-made data analysis agent built on these connectors.

Development

make sync                 # install everything with uv
make verify PKG=fred      # lint + types + tests for one package
make verify-all           # the same for every package

make verify runs the same checks as CI. See CONTRIBUTING.md.

License

Apache-2.0. See LICENSE.