alpha-vantage

1# Alpha Vantage — Financial Market Data
2 
3Access 20+ years of global financial data: equities, options, forex, crypto, commodities, economic indicators, and 50+ technical indicators.
4 
5## API Key Setup (Required)
6 
71. Get a free key at https://www.alphavantage.co/support/#api-key (premium plans available for higher rate limits)
82. Set as environment variable:
9 
10```bash
11export ALPHAVANTAGE_API_KEY="your_key_here"
12```
13 
14## Installation
15 
16```bash
17uv pip install requests pandas
18```
19 
20## Base URL & Request Pattern
21 
22All requests go to:
23 
24```
25https://www.alphavantage.co/query?function=FUNCTION_NAME&apikey=YOUR_KEY&...params
26```
27 
28```python
29import requests
30import os
31 
32API_KEY = os.environ.get("ALPHAVANTAGE_API_KEY")
33BASE_URL = "https://www.alphavantage.co/query"
34 
35def av_get(function, **params):
36    response = requests.get(BASE_URL, params={"function": function, "apikey": API_KEY, **params})
37    return response.json()
38```
39 
40## Quick Start Examples
41 
42```python
43# Stock quote (latest price)
44quote = av_get("GLOBAL_QUOTE", symbol="AAPL")
45price = quote["Global Quote"]["05. price"]
46 
47# Daily OHLCV
48daily = av_get("TIME_SERIES_DAILY", symbol="AAPL", outputsize="compact")
49ts = daily["Time Series (Daily)"]
50 
51# Company fundamentals
52overview = av_get("OVERVIEW", symbol="AAPL")
53print(overview["MarketCapitalization"], overview["PERatio"])
54 
55# Income statement
56income = av_get("INCOME_STATEMENT", symbol="AAPL")
57annual = income["annualReports"][0]  # Most recent annual
58 
59# Crypto price
60…