alphavantage

1# Alpha Vantage
2 
3## Purpose
4Read-only stock market data: latest quote for a symbol and the last 5 daily closes. Use when the user asks for a stock quote, a stock price, or mentions Alpha Vantage.
5 
6## Tooling
7All commands go through `bin/alphavantage.py`:
8 
9```bash
10bin/alphavantage.py quote --symbol IBM    # latest quote
11bin/alphavantage.py daily --symbol AAPL   # last 5 daily closes
12```
13 
14## Auth
15- Provider id: `alphavantage` (credential is collected as `custom.alphavantage`)
16- Collection: API key via the secure credential flow (`credentials.request_api_access`)
17- Get a key: alphavantage.co/support/#api-key (free tier: 25 calls/day, 5/minute)
18- Allowed hosts: `www.alphavantage.co`
19- Status check: `bin/alphavantage.py quote --symbol IBM`
20- Connect placement: `query_param:apikey`
21 
22## Operating Rules
231. This connector is read-only: it only reads market data. It never trades, never modifies anything, and never sends anything on the user's behalf.
242. Respect the free tier limits (25 calls/day, 5/minute): batch symbols into as few calls as possible and never retry aggressively; if the API returns a rate-limit "Note", back off and tell the user.
253. Alpha Vantage returns HTTP 200 even for errors; the CLI inspects the JSON body for "Error Message", "Note", and "Information" and exits with a clean error: report that error verbatim instead of inventing a quote.
264. This is market data, not financial advice.
27…