superkit-mcp-server 1.0.2 → 1.0.3

package/skills/tech/alpha-vantage/references/commodities.md

@@ -0,0 +1,153 @@
+# Commodities APIs
+
+Historical data for major commodities. All functions return `{"name": "...", "interval": "...", "unit": "...", "data": [{"date": "...", "value": "..."}, ...]}`.
+
+## Metals
+
+### GOLD_SILVER_SPOT — Real-time Gold & Silver Spot Price
+
+**Required:** `symbol` — `GOLD` / `XAU` for gold; `SILVER` / `XAG` for silver
+
+```python
+data = av_get("GOLD_SILVER_SPOT", symbol="GOLD")
+# Returns current spot price
+print(data["price"], data["unit"], data["timestamp"])
+
+data = av_get("GOLD_SILVER_SPOT", symbol="SILVER")
+```
+
+### GOLD_SILVER_HISTORY — Historical Gold & Silver Prices
+
+**Required:** `symbol` (`GOLD`, `XAU`, `SILVER`, `XAG`), `interval` (`daily`, `weekly`, `monthly`)
+
+```python
+data = av_get("GOLD_SILVER_HISTORY", symbol="GOLD", interval="daily")
+for obs in data["data"][:10]:
+    print(obs["date"], obs["value"])
+# unit: USD per troy ounce
+```
+
+## Oil & Gas
+
+### WTI — Crude Oil (West Texas Intermediate)
+
+**Optional:** `interval` (`daily`, `weekly`, `monthly`) — default: `monthly`
+
+```python
+data = av_get("WTI", interval="daily")
+for obs in data["data"][:10]:
+    print(obs["date"], obs["value"])
+# unit: dollars per barrel
+```
+
+### BRENT — Crude Oil (Brent)
+
+**Optional:** `interval` (`daily`, `weekly`, `monthly`) — default: `monthly`
+
+```python
+data = av_get("BRENT", interval="daily")
+```
+
+### NATURAL_GAS — Henry Hub Natural Gas Spot Price
+
+**Optional:** `interval` (`daily`, `weekly`, `monthly`) — default: `monthly`
+
+```python
+data = av_get("NATURAL_GAS", interval="monthly")
+# unit: dollars per million BTU
+```
+
+## Industrial Metals
+
+### COPPER — Global Price of Copper
+
+**Optional:** `interval` (`monthly`, `quarterly`, `annual`) — default: `monthly`
+
+```python
+data = av_get("COPPER", interval="monthly")
+# unit: USD per metric ton
+```
+
+### ALUMINUM — Global Price of Aluminum
+
+**Optional:** `interval` (`monthly`, `quarterly`, `annual`) — default: `monthly`
+
+```python
+data = av_get("ALUMINUM", interval="monthly")
+```
+
+## Agricultural Commodities
+
+### WHEAT — Global Price of Wheat
+
+**Optional:** `interval` (`monthly`, `quarterly`, `annual`) — default: `monthly`
+
+```python
+data = av_get("WHEAT", interval="monthly")
+# unit: USD per metric ton
+```
+
+### CORN — Global Price of Corn (Maize)
+
+**Optional:** `interval` (`monthly`, `quarterly`, `annual`) — default: `monthly`
+
+```python
+data = av_get("CORN", interval="monthly")
+```
+
+### COTTON — Global Price of Cotton
+
+**Optional:** `interval` (`monthly`, `quarterly`, `annual`) — default: `monthly`
+
+```python
+data = av_get("COTTON", interval="monthly")
+# unit: USD per pound
+```
+
+### SUGAR — Global Price of Sugar
+
+**Optional:** `interval` (`monthly`, `quarterly`, `annual`) — default: `monthly`
+
+```python
+data = av_get("SUGAR", interval="monthly")
+# unit: cents per pound
+```
+
+### COFFEE — Global Price of Coffee
+
+**Optional:** `interval` (`monthly`, `quarterly`, `annual`) — default: `monthly`
+
+```python
+data = av_get("COFFEE", interval="monthly")
+# unit: USD per pound
+```
+
+## ALL_COMMODITIES — Global Price Index of All Commodities
+
+IMF Primary Commodity Price Index.
+
+**Optional:** `interval` (`monthly`, `quarterly`, `annual`) — default: `monthly`
+
+```python
+data = av_get("ALL_COMMODITIES", interval="monthly")
+# Composite index of all commodities
+```
+
+## Convert to DataFrame
+
+```python
+import pandas as pd
+
+def commodity_to_df(function, **kwargs):
+    data = av_get(function, **kwargs)
+    df = pd.DataFrame(data["data"])
+    df["date"] = pd.to_datetime(df["date"])
+    df["value"] = pd.to_numeric(df["value"], errors="coerce")
+    return df.set_index("date").sort_index()
+
+# Compare oil prices
+wti_df = commodity_to_df("WTI", interval="monthly")
+brent_df = commodity_to_df("BRENT", interval="monthly")
+spread = brent_df["value"] - wti_df["value"]
+print(spread.tail())
+```

package/skills/tech/alpha-vantage/references/economic-indicators.md

@@ -0,0 +1,158 @@
+# Economic Indicators APIs
+
+All economic indicators return US data and follow the same response structure:
+
+```json
+{
+  "name": "Real Gross Domestic Product",
+  "interval": "annual",
+  "unit": "billions of chained 2012 dollars",
+  "data": [{"date": "2023-01-01", "value": "22067.1"}, ...]
+}
+```
+
+## GDP
+
+### REAL_GDP — Real Gross Domestic Product
+
+Source: US Bureau of Economic Analysis via FRED.
+
+**Optional:** `interval` (`annual`, `quarterly`) — default: `annual`
+
+```python
+data = av_get("REAL_GDP", interval="quarterly")
+latest = data["data"][0]
+print(latest["date"], latest["value"])
+# unit: billions of chained 2012 dollars
+```
+
+### REAL_GDP_PER_CAPITA — Real GDP Per Capita
+
+**No interval parameter** — quarterly data only.
+
+```python
+data = av_get("REAL_GDP_PER_CAPITA")
+# unit: chained 2012 dollars
+```
+
+## Interest Rates
+
+### TREASURY_YIELD — US Treasury Yield
+
+**Optional:**
+- `interval` (`daily`, `weekly`, `monthly`) — default: `monthly`
+- `maturity` (`3month`, `2year`, `5year`, `7year`, `10year`, `30year`) — default: `10year`
+
+```python
+# 10-year treasury yield (daily)
+data = av_get("TREASURY_YIELD", interval="daily", maturity="10year")
+for obs in data["data"][:5]:
+    print(obs["date"], obs["value"])
+# unit: percent
+
+# 2-year vs 10-year spread (yield curve)
+two_yr = av_get("TREASURY_YIELD", interval="monthly", maturity="2year")
+ten_yr = av_get("TREASURY_YIELD", interval="monthly", maturity="10year")
+```
+
+### FEDERAL_FUNDS_RATE — Federal Funds Rate
+
+**Optional:** `interval` (`daily`, `weekly`, `monthly`) — default: `monthly`
+
+```python
+data = av_get("FEDERAL_FUNDS_RATE", interval="monthly")
+# unit: percent
+```
+
+## Inflation
+
+### CPI — Consumer Price Index
+
+**Optional:** `interval` (`monthly`, `semiannual`) — default: `monthly`
+
+```python
+data = av_get("CPI", interval="monthly")
+# unit: index 1982-1984 = 100
+```
+
+### INFLATION — Annual Inflation Rate
+
+**No parameters** — annual data only.
+
+```python
+data = av_get("INFLATION")
+# unit: percent (YoY change in CPI)
+```
+
+## Labor Market
+
+### UNEMPLOYMENT — Unemployment Rate
+
+**No parameters** — monthly data only.
+
+```python
+data = av_get("UNEMPLOYMENT")
+latest = data["data"][0]
+print(latest["date"], latest["value"])
+# unit: percent
+```
+
+### NONFARM_PAYROLL — Nonfarm Payroll
+
+**No parameters** — monthly data only.
+
+```python
+data = av_get("NONFARM_PAYROLL")
+# unit: thousands of persons
+```
+
+## Consumer Spending
+
+### RETAIL_SALES — Monthly Retail Sales
+
+**No parameters** — monthly data only.
+
+```python
+data = av_get("RETAIL_SALES")
+# unit: millions of dollars
+```
+
+### DURABLES — Durable Goods Orders
+
+**No parameters** — monthly data only.
+
+```python
+data = av_get("DURABLES")
+# unit: millions of dollars
+```
+
+## Macro Dashboard Example
+
+```python
+import pandas as pd
+
+def econ_to_series(function, **kwargs):
+    data = av_get(function, **kwargs)
+    df = pd.DataFrame(data["data"])
+    df["date"] = pd.to_datetime(df["date"])
+    df["value"] = pd.to_numeric(df["value"], errors="coerce")
+    return df.set_index("date")["value"].sort_index()
+
+# Build economic snapshot
+gdp = econ_to_series("REAL_GDP", interval="quarterly")
+fed_funds = econ_to_series("FEDERAL_FUNDS_RATE", interval="monthly")
+unemployment = econ_to_series("UNEMPLOYMENT")
+cpi = econ_to_series("CPI", interval="monthly")
+ten_yr = econ_to_series("TREASURY_YIELD", interval="monthly", maturity="10year")
+
+print(f"Latest GDP: {gdp.iloc[-1]:.1f} billion (chained 2012$)")
+print(f"Fed Funds Rate: {fed_funds.iloc[-1]:.2f}%")
+print(f"Unemployment: {unemployment.iloc[-1]:.1f}%")
+print(f"CPI: {cpi.iloc[-1]:.1f}")
+print(f"10-Year Treasury: {ten_yr.iloc[-1]:.2f}%")
+
+# Yield curve inversion check
+two_yr = econ_to_series("TREASURY_YIELD", interval="monthly", maturity="2year")
+spread = ten_yr - two_yr
+print(f"Yield curve spread (10yr - 2yr): {spread.iloc[-1]:.2f}% ({'inverted' if spread.iloc[-1] < 0 else 'normal'})")
+```

package/skills/tech/alpha-vantage/references/forex-crypto.md

@@ -0,0 +1,154 @@
+# Forex (FX) & Cryptocurrency APIs
+
+## Foreign Exchange Rates
+
+### CURRENCY_EXCHANGE_RATE — Realtime Exchange Rate
+
+Returns the realtime exchange rate for any currency pair (fiat or crypto).
+
+**Required:** `from_currency`, `to_currency`
+
+```python
+# Fiat to fiat
+data = av_get("CURRENCY_EXCHANGE_RATE", from_currency="USD", to_currency="EUR")
+rate_info = data["Realtime Currency Exchange Rate"]
+print(rate_info["5. Exchange Rate"])   # e.g., "0.92"
+print(rate_info["6. Last Refreshed"])
+print(rate_info["8. Bid Price"])
+print(rate_info["9. Ask Price"])
+# Full fields: "1. From_Currency Code", "2. From_Currency Name",
+#              "3. To_Currency Code", "4. To_Currency Name",
+#              "5. Exchange Rate", "6. Last Refreshed",
+#              "7. Time Zone", "8. Bid Price", "9. Ask Price"
+
+# Crypto to fiat
+data = av_get("CURRENCY_EXCHANGE_RATE", from_currency="BTC", to_currency="USD")
+print(data["Realtime Currency Exchange Rate"]["5. Exchange Rate"])
+```
+
+### FX_INTRADAY — Intraday Forex OHLCV (Premium)
+
+**Required:** `from_symbol`, `to_symbol`, `interval` (`1min`, `5min`, `15min`, `30min`, `60min`)
+
+**Optional:** `outputsize` (`compact`/`full`), `datatype`
+
+```python
+data = av_get("FX_INTRADAY", from_symbol="EUR", to_symbol="USD", interval="5min")
+ts = data["Time Series FX (5min)"]
+# Key: "2024-01-15 16:00:00" → {"1. open", "2. high", "3. low", "4. close"}
+```
+
+### FX_DAILY — Daily Forex OHLCV
+
+**Required:** `from_symbol`, `to_symbol`
+
+**Optional:** `outputsize` (`compact`/`full`), `datatype`
+
+```python
+data = av_get("FX_DAILY", from_symbol="EUR", to_symbol="USD", outputsize="full")
+ts = data["Time Series FX (Daily)"]
+# Key: "2024-01-15" → {"1. open", "2. high", "3. low", "4. close"}
+```
+
+### FX_WEEKLY — Weekly Forex OHLCV
+
+```python
+data = av_get("FX_WEEKLY", from_symbol="EUR", to_symbol="USD")
+ts = data["Time Series FX (Weekly)"]
+```
+
+### FX_MONTHLY — Monthly Forex OHLCV
+
+```python
+data = av_get("FX_MONTHLY", from_symbol="EUR", to_symbol="USD")
+ts = data["Time Series FX (Monthly)"]
+```
+
+## Common Currency Codes
+
+| Code | Currency |
+|------|---------|
+| USD | US Dollar |
+| EUR | Euro |
+| GBP | British Pound |
+| JPY | Japanese Yen |
+| CHF | Swiss Franc |
+| CAD | Canadian Dollar |
+| AUD | Australian Dollar |
+| CNY | Chinese Yuan |
+| HKD | Hong Kong Dollar |
+| BTC | Bitcoin |
+| ETH | Ethereum |
+
+---
+
+## Cryptocurrency
+
+### CRYPTO_INTRADAY — Crypto Intraday OHLCV (Premium)
+
+**Required:** `symbol`, `market`, `interval` (`1min`, `5min`, `15min`, `30min`, `60min`)
+
+**Optional:** `outputsize` (`compact`/`full`), `datatype`
+
+```python
+data = av_get("CRYPTO_INTRADAY", symbol="ETH", market="USD", interval="5min")
+ts = data["Time Series Crypto (5min)"]
+# Key: "2024-01-15 16:00:00" → {"1. open", "2. high", "3. low", "4. close", "5. volume"}
+```
+
+### DIGITAL_CURRENCY_DAILY — Daily Crypto OHLCV
+
+**Required:** `symbol`, `market`
+
+```python
+data = av_get("DIGITAL_CURRENCY_DAILY", symbol="BTC", market="USD")
+ts = data["Time Series (Digital Currency Daily)"]
+# Key: "2024-01-15" → {
+#   "1a. open (USD)", "1b. open (USD)",
+#   "2a. high (USD)", "2b. high (USD)",
+#   "3a. low (USD)",  "3b. low (USD)",
+#   "4a. close (USD)", "4b. close (USD)",
+#   "5. volume", "6. market cap (USD)"
+# }
+
+# Convert to DataFrame
+import pandas as pd
+df = pd.DataFrame.from_dict(ts, orient="index")
+df.index = pd.to_datetime(df.index)
+df = df.sort_index()
+# Extract close price
+df["close"] = pd.to_numeric(df["4a. close (USD)"])
+```
+
+### DIGITAL_CURRENCY_WEEKLY — Weekly Crypto OHLCV
+
+**Required:** `symbol`, `market`
+
+```python
+data = av_get("DIGITAL_CURRENCY_WEEKLY", symbol="BTC", market="USD")
+ts = data["Time Series (Digital Currency Weekly)"]
+```
+
+### DIGITAL_CURRENCY_MONTHLY — Monthly Crypto OHLCV
+
+**Required:** `symbol`, `market`
+
+```python
+data = av_get("DIGITAL_CURRENCY_MONTHLY", symbol="ETH", market="USD")
+ts = data["Time Series (Digital Currency Monthly)"]
+```
+
+## Common Crypto Symbols
+
+| Symbol | Name |
+|--------|------|
+| BTC | Bitcoin |
+| ETH | Ethereum |
+| BNB | Binance Coin |
+| XRP | Ripple |
+| ADA | Cardano |
+| SOL | Solana |
+| DOGE | Dogecoin |
+| AVAX | Avalanche |
+| DOT | Polkadot |
+| MATIC | Polygon |

package/skills/tech/alpha-vantage/references/fundamentals.md

@@ -0,0 +1,223 @@
+# Fundamental Data APIs
+
+## OVERVIEW — Company Overview
+
+Returns key company information, valuation metrics, and financial ratios.
+
+**Required:** `symbol`
+
+```python
+data = av_get("OVERVIEW", symbol="AAPL")
+
+# Key fields returned:
+# "Symbol", "AssetType", "Name", "Description", "Exchange", "Currency"
+# "Country", "Sector", "Industry", "Address"
+# "MarketCapitalization", "EBITDA", "PERatio", "PEGRatio"
+# "BookValue", "DividendPerShare", "DividendYield", "EPS"
+# "RevenuePerShareTTM", "ProfitMargin", "OperatingMarginTTM"
+# "ReturnOnAssetsTTM", "ReturnOnEquityTTM"
+# "RevenueTTM", "GrossProfitTTM", "DilutedEPSTTM"
+# "QuarterlyEarningsGrowthYOY", "QuarterlyRevenueGrowthYOY"
+# "AnalystTargetPrice", "AnalystRatingStrongBuy", "AnalystRatingBuy",
+# "AnalystRatingHold", "AnalystRatingSell", "AnalystRatingStrongSell"
+# "TrailingPE", "ForwardPE", "PriceToSalesRatioTTM"
+# "PriceToBookRatio", "EVToRevenue", "EVToEBITDA"
+# "Beta", "52WeekHigh", "52WeekLow", "50DayMovingAverage", "200DayMovingAverage"
+# "SharesOutstanding", "DividendDate", "ExDividendDate", "FiscalYearEnd"
+
+print(data["MarketCapitalization"])  # "2850000000000"
+print(data["PERatio"])               # "29.50"
+print(data["Sector"])                # "TECHNOLOGY"
+```
+
+## ETF_PROFILE — ETF Profile & Holdings
+
+**Required:** `symbol`
+
+```python
+data = av_get("ETF_PROFILE", symbol="QQQ")
+# Fields: "net_assets", "nav", "inception_date", "description",
+#         "asset_allocation" (stocks/bonds/cash/etc.)
+#         "sectors" (list of sector weights)
+#         "holdings" (top holdings list)
+for h in data["holdings"][:5]:
+    print(h["symbol"], h["description"], h["weight"])
+```
+
+## DIVIDENDS — Corporate Dividend History
+
+**Required:** `symbol`
+
+```python
+data = av_get("DIVIDENDS", symbol="IBM")
+divs = data["data"]
+for d in divs:
+    print(d["ex_dividend_date"], d["amount"])
+# Fields per record: "ex_dividend_date", "declaration_date",
+#                    "record_date", "payment_date", "amount"
+```
+
+## SPLITS — Stock Split History
+
+**Required:** `symbol`
+
+```python
+data = av_get("SPLITS", symbol="AAPL")
+splits = data["data"]
+for s in splits:
+    print(s["effective_date"], s["split_factor"])
+# Fields: "effective_date", "split_factor" (e.g., "4/1" for 4-for-1 split)
+```
+
+## INCOME_STATEMENT — Income Statement
+
+Returns annual and quarterly income statements.
+
+**Required:** `symbol`
+
+```python
+data = av_get("INCOME_STATEMENT", symbol="IBM")
+annual = data["annualReports"]    # list, most recent first
+quarterly = data["quarterlyReports"]  # list, most recent first
+
+yr = annual[0]  # Most recent fiscal year
+print(yr["fiscalDateEnding"])       # "2023-12-31"
+print(yr["totalRevenue"])           # "61860000000"
+print(yr["grossProfit"])            # "32688000000"
+print(yr["operatingIncome"])        # "..."
+print(yr["netIncome"])              # "..."
+print(yr["ebitda"])                 # "..."
+# Other keys: "reportedCurrency", "costOfRevenue", "costofGoodsAndServicesSold",
+#   "sellingGeneralAndAdministrative", "researchAndDevelopment",
+#   "operatingExpenses", "investmentIncomeNet", "netInterestIncome",
+#   "interestIncome", "interestExpense", "nonInterestIncome",
+#   "otherNonOperatingIncome", "depreciation",
+#   "depreciationAndAmortization", "incomeBeforeTax",
+#   "incomeTaxExpense", "interestAndDebtExpense",
+#   "netIncomeFromContinuingOperations", "comprehensiveIncomeNetOfTax",
+#   "ebit", "dilutedEPS", "basicEPS"
+```
+
+## BALANCE_SHEET — Balance Sheet
+
+**Required:** `symbol`
+
+```python
+data = av_get("BALANCE_SHEET", symbol="IBM")
+annual = data["annualReports"]
+
+yr = annual[0]
+print(yr["totalAssets"])           # "..."
+print(yr["totalLiabilities"])      # "..."
+print(yr["totalShareholderEquity"]) # "..."
+# Other keys: "reportedCurrency", "fiscalDateEnding",
+#   "cashAndCashEquivalentsAtCarryingValue", "cashAndShortTermInvestments",
+#   "inventory", "currentNetReceivables", "totalCurrentAssets",
+#   "propertyPlantEquipmentNet", "intangibleAssets",
+#   "intangibleAssetsExcludingGoodwill", "goodwill", "investments",
+#   "longTermInvestments", "shortTermInvestments", "otherCurrentAssets",
+#   "otherNonCurrrentAssets", "currentAccountsPayable", "deferredRevenue",
+#   "currentDebt", "shortTermDebt", "totalCurrentLiabilities",
+#   "capitalLeaseObligations", "longTermDebt", "currentLongTermDebt",
+#   "longTermDebtNoncurrent", "shortLongTermDebtTotal",
+#   "otherCurrentLiabilities", "otherNonCurrentLiabilities",
+#   "totalNonCurrentLiabilities", "retainedEarnings",
+#   "additionalPaidInCapital", "commonStockSharesOutstanding"
+```
+
+## CASH_FLOW — Cash Flow Statement
+
+**Required:** `symbol`
+
+```python
+data = av_get("CASH_FLOW", symbol="IBM")
+annual = data["annualReports"]
+
+yr = annual[0]
+print(yr["operatingCashflow"])              # "..."
+print(yr["capitalExpenditures"])            # "..."
+print(yr["cashflowFromInvestment"])         # "..."
+print(yr["cashflowFromFinancing"])          # "..."
+# Other keys: "reportedCurrency", "fiscalDateEnding",
+#   "paymentsForRepurchaseOfCommonStock", "dividendPayout",
+#   "dividendPayoutCommonStock", "dividendPayoutPreferredStock",
+#   "proceedsFromIssuanceOfCommonStock", "changeInOperatingLiabilities",
+#   "changeInOperatingAssets", "depreciationDepletionAndAmortization",
+#   "capitalExpenditures", "changeInReceivables", "changeInInventory",
+#   "profitLoss", "netIncomeFromContinuingOperations"
+```
+
+## SHARES_OUTSTANDING — Shares Outstanding History
+
+**Required:** `symbol`
+
+```python
+data = av_get("SHARES_OUTSTANDING", symbol="AAPL")
+shares = data["data"]
+for s in shares[:5]:
+    print(s["date"], s["reportedShares"])
+```
+
+## EARNINGS — Earnings History (EPS)
+
+Returns annual and quarterly EPS + surprise data.
+
+**Required:** `symbol`
+
+```python
+data = av_get("EARNINGS", symbol="IBM")
+annual = data["annualEarnings"]
+quarterly = data["quarterlyEarnings"]
+
+# Annual: "fiscalDateEnding", "reportedEPS"
+# Quarterly: "fiscalDateEnding", "reportedDate", "reportedEPS",
+#            "estimatedEPS", "surprise", "surprisePercentage"
+q = quarterly[0]
+print(q["reportedEPS"], q["estimatedEPS"], q["surprisePercentage"])
+```
+
+## EARNINGS_CALENDAR — Upcoming Earnings Dates
+
+Returns earnings release schedule for the next 3-12 months.
+
+**Optional:** `symbol` (if omitted, returns all companies), `horizon` (`3month`, `6month`, `12month`)
+
+```python
+# Returns CSV format - use requests directly
+import requests, csv, io, os
+resp = requests.get(
+    "https://www.alphavantage.co/query",
+    params={"function": "EARNINGS_CALENDAR", "symbol": "IBM", "apikey": os.environ["ALPHAVANTAGE_API_KEY"]}
+)
+reader = csv.DictReader(io.StringIO(resp.text))
+for row in reader:
+    print(row["symbol"], row["name"], row["reportDate"], row["estimate"])
+```
+
+## LISTING_STATUS — Listed/Delisted Tickers
+
+**Optional:** `date` (format `YYYY-MM-DD`), `state` (`active` or `delisted`)
+
+```python
+# Returns CSV
+resp = requests.get(
+    "https://www.alphavantage.co/query",
+    params={"function": "LISTING_STATUS", "state": "active", "apikey": API_KEY}
+)
+reader = csv.DictReader(io.StringIO(resp.text))
+# Fields: "symbol", "name", "exchange", "assetType", "ipoDate",
+#         "delistingDate", "status"
+```
+
+## IPO_CALENDAR — Upcoming IPOs
+
+```python
+# Returns CSV
+resp = requests.get(
+    "https://www.alphavantage.co/query",
+    params={"function": "IPO_CALENDAR", "apikey": API_KEY}
+)
+reader = csv.DictReader(io.StringIO(resp.text))
+for row in reader:
+    print(row["symbol"], row["name"], row["ipoDate"], row["priceRangeLow"], row["priceRangeHigh"])
+```