parsimony-alpha-vantage 0.4.0

Alpha Vantage connector for the parsimony framework

parsimony-alpha-vantage

Alpha Vantage connector — equities, fundamentals, forex, crypto, precious metals, US economic indicators, technical indicators, and news sentiment.

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

Connectors

29 connectors total (28 @connector + 1 @enumerator), grouped by category. See the Alpha Vantage docs for endpoint-level reference.

Group	Count	Examples
Discovery	1	alpha_vantage_search
Market data (OHLCV)	4	alpha_vantage_quote, alpha_vantage_daily, alpha_vantage_weekly, alpha_vantage_monthly, alpha_vantage_intraday
Company fundamentals	6	alpha_vantage_overview, alpha_vantage_income_statement, alpha_vantage_balance_sheet, alpha_vantage_cash_flow, alpha_vantage_earnings, alpha_vantage_etf_profile
Calendars	2	alpha_vantage_earnings_calendar, alpha_vantage_ipo_calendar
Forex	4	alpha_vantage_fx_rate, alpha_vantage_fx_daily, alpha_vantage_fx_weekly, alpha_vantage_fx_monthly
Crypto	3	alpha_vantage_crypto_daily, alpha_vantage_crypto_weekly, alpha_vantage_crypto_monthly
Economic indicators	1	alpha_vantage_econ (GDP, CPI, unemployment, fed funds, treasury yield, etc.)
Precious metals	2	alpha_vantage_metal_spot, alpha_vantage_metal_history
Alpha intelligence	2	alpha_vantage_news, alpha_vantage_top_movers
Technical indicators	1	alpha_vantage_technical (50+ indicators via unified endpoint)
Options	1	alpha_vantage_options (premium plan only)
Enumerator	1	enumerate_alpha_vantage (US listings, active or delisted)

Commodity series (WTI, Brent, natural gas, copper, etc.) are intentionally omitted — use the FRED connector instead, which has superior historical coverage.

Install

pip install parsimony-alpha-vantage

Pulls in parsimony-core>=0.4,<0.5 automatically. Verify discovery:

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

Configuration

Set the following environment variable:

export ALPHA_VANTAGE_API_KEY="<your-key>"

Get a free key at https://www.alphavantage.co/support/#api-key. Free tier: 25 requests/day across all endpoints.

Quick start

import asyncio
from parsimony_alpha_vantage import CONNECTORS

async def main():
    connectors = CONNECTORS.bind_env()
    result = await connectors["alpha_vantage_quote"](symbol="IBM")
    print(result.data.head())

asyncio.run(main())

For multi-plugin composition (autoloads everything installed):

from parsimony import discover
connectors = discover.load_all().bind_env()

Provider

• Homepage: https://www.alphavantage.co
• API docs: https://www.alphavantage.co/documentation/
• Rate limits: free tier 25 requests/day, 5 requests/minute (per the plugin docstring)

License

See LICENSE.