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.

Total: 28 @connector + 1 @enumerator = 29.

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 a compatible parsimony 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 os
from parsimony_alpha_vantage import load

# load(api_key=...) binds the key across every connector and strips it
# from provenance (it is declared secrets=("api_key",) on each verb).
connectors = load(api_key=os.environ["ALPHA_VANTAGE_API_KEY"])
result = connectors["alpha_vantage_quote"](symbol="IBM")
print(result.raw.head())

For multi-plugin composition (autoloads everything installed):

from parsimony import discover

connectors = discover.load_all()

Provider

• Homepage: https://www.alphavantage.co
• API docs: https://www.alphavantage.co/documentation/
• Rate limits: free tier 25 requests/day shared across all endpoints (hard cap); the API returns an HTTP 200 Information body when the cap is hit, mapped to RateLimitError

License

See LICENSE.