parsimony-tiingo 0.0.1

Tiingo connector for the parsimony framework

parsimony-tiingo

Tiingo connector plugin for parsimony — equities, crypto, and forex prices, company metadata, fundamentals, and news.

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

Connectors

Name	Kind	Description
Discovery
tiingo_search	connector	Search Tiingo for stocks, ETFs, mutual funds, and crypto by name or ticker.
Equities
tiingo_eod	connector	End-of-day OHLCV with split/dividend-adjusted columns. Free tier: full history.
tiingo_iex	connector	Real-time IEX top-of-book quotes (composite last, OHLV, bid/ask, sizes).
tiingo_iex_historical	connector	Historical IEX intraday OHLC at a given resample frequency (last ~2000 points).
tiingo_meta	connector	Equity metadata: name, description, exchange, listing dates.
Fundamentals
tiingo_fundamentals_meta	connector	Sector, industry, SIC, currency, location, SEC filing link, ADR flag.
tiingo_fundamentals_definitions	connector	All fundamental metric definitions (dataCode, name, statement type, units).
News
tiingo_news	connector	News articles filtered by tickers, source, date range. Power+ plan only.
Crypto
tiingo_crypto_prices	connector	Historical crypto OHLCV at multiple resample frequencies.
tiingo_crypto_top	connector	Real-time top-of-book quotes for crypto pairs.
Forex
tiingo_fx_prices	connector	Historical forex OHLC at multiple resample frequencies.
tiingo_fx_top	connector	Real-time top-of-book forex quotes (mid, bid/ask, sizes).
Enumeration
enumerate_tiingo	enumerator	Supported-tickers list (~127k rows) for catalog indexing.

Install

pip install parsimony-tiingo

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 TIINGO_API_KEY="<your-key>"

Get a key at https://www.tiingo.com/account/api/token.

Quick start

import os
from parsimony_tiingo import load

# Bind the key off the call surface (it never enters provenance).
connectors = load(api_key=os.environ["TIINGO_API_KEY"])
result = connectors["tiingo_eod"](ticker="AAPL")
print(result.data.head())

The key is declared as a secret on every verb (stripped from provenance) and resolved from the bound value or, as a dev fallback, the TIINGO_API_KEY environment variable. A missing key fails fast with UnauthorizedError.

For multi-plugin composition:

from parsimony import discover
connectors = discover.load_all()

Provider

• Homepage: https://www.tiingo.com
• API docs: https://www.tiingo.com/documentation/general/overview

License

See LICENSE.