wotann 0.5.0 → 0.5.39

package/skills/scientific/database-lookup/references/alphavantage.md

@@ -0,0 +1,261 @@
+# Alpha Vantage API Reference
+
+## Overview
+Alpha Vantage provides free APIs for real-time and historical stock prices, forex rates, cryptocurrency data, technical indicators, and fundamental data (earnings, balance sheets, income statements). Covers global equities, ETFs, mutual funds, and commodities.
+
+## Base URL
+```
+https://www.alphavantage.co/query
+```
+
+All requests use a single endpoint with `function` parameter to select the data type.
+
+## Authentication
+- **API Key: REQUIRED.** Get a free key at https://www.alphavantage.co/support/#api-key
+- Pass as query parameter: `&apikey=YOUR_KEY`
+
+## Rate Limits
+- **Free tier:** 25 requests per day. 5 calls per minute (as of late 2024; previously was 5/min + 500/day).
+- **Premium tiers** available for higher limits (30, 75, 150+ calls/min).
+- Exceeding limits returns a polite JSON message, not an error code.
+
+---
+
+## Key Endpoints (by `function` parameter)
+
+### 1. Stock Time Series
+
+#### Intraday
+```
+GET /query?function=TIME_SERIES_INTRADAY&symbol={symbol}&interval={interval}&apikey={key}
+```
+| Parameter | Required | Values |
+|-----------|----------|--------|
+| `symbol` | Yes | Ticker symbol (e.g., `AAPL`, `MSFT`) |
+| `interval` | Yes | `1min`, `5min`, `15min`, `30min`, `60min` |
+| `outputsize` | No | `compact` (last 100 points, default) or `full` (full history) |
+| `adjusted` | No | `true` (default) or `false` |
+| `datatype` | No | `json` (default) or `csv` |
+
+**Example:**
+```
+https://www.alphavantage.co/query?function=TIME_SERIES_INTRADAY&symbol=AAPL&interval=5min&apikey=YOUR_KEY
+```
+
+#### Daily
+```
+GET /query?function=TIME_SERIES_DAILY&symbol=AAPL&apikey=YOUR_KEY
+```
+
+#### Daily (Adjusted for splits/dividends)
+```
+GET /query?function=TIME_SERIES_DAILY_ADJUSTED&symbol=AAPL&outputsize=full&apikey=YOUR_KEY
+```
+
+#### Weekly / Monthly
+```
+GET /query?function=TIME_SERIES_WEEKLY_ADJUSTED&symbol=AAPL&apikey=YOUR_KEY
+GET /query?function=TIME_SERIES_MONTHLY_ADJUSTED&symbol=AAPL&apikey=YOUR_KEY
+```
+
+**Response (Daily):**
+```json
+{
+  "Meta Data": {
+    "1. Information": "Daily Prices (open, high, low, close) and Volumes",
+    "2. Symbol": "AAPL",
+    "3. Last Refreshed": "2024-11-01",
+    "4. Output Size": "Compact",
+    "5. Time Zone": "US/Eastern"
+  },
+  "Time Series (Daily)": {
+    "2024-11-01": {
+      "1. open": "228.6900",
+      "2. high": "229.8600",
+      "3. low": "225.8200",
+      "4. close": "228.5200",
+      "5. volume": "50423432"
+    },
+    "2024-10-31": {
+      "1. open": "229.3400",
+      "2. high": "230.2000",
+      "3. low": "226.3700",
+      "4. close": "227.5500",
+      "5. volume": "51235678"
+    }
+  }
+}
+```
+
+---
+
+### 2. Stock Search (Symbol Lookup)
+```
+GET /query?function=SYMBOL_SEARCH&keywords={query}&apikey={key}
+```
+
+**Example:**
+```
+https://www.alphavantage.co/query?function=SYMBOL_SEARCH&keywords=microsoft&apikey=YOUR_KEY
+```
+
+**Response:**
+```json
+{
+  "bestMatches": [
+    {
+      "1. symbol": "MSFT",
+      "2. name": "Microsoft Corporation",
+      "3. type": "Equity",
+      "4. region": "United States",
+      "5. marketOpen": "09:30",
+      "6. marketClose": "16:00",
+      "7. timezone": "UTC-04",
+      "8. currency": "USD",
+      "9. matchScore": "1.0000"
+    }
+  ]
+}
+```
+
+---
+
+### 3. Global Quote (Real-Time Price)
+```
+GET /query?function=GLOBAL_QUOTE&symbol=AAPL&apikey=YOUR_KEY
+```
+
+Returns latest price, volume, change, change percent for a single symbol.
+
+---
+
+### 4. Forex (FX) Rates
+
+#### Real-Time Exchange Rate
+```
+GET /query?function=CURRENCY_EXCHANGE_RATE&from_currency=USD&to_currency=EUR&apikey=YOUR_KEY
+```
+
+#### FX Time Series
+```
+GET /query?function=FX_DAILY&from_symbol=EUR&to_symbol=USD&apikey=YOUR_KEY
+GET /query?function=FX_WEEKLY&from_symbol=EUR&to_symbol=USD&apikey=YOUR_KEY
+GET /query?function=FX_MONTHLY&from_symbol=EUR&to_symbol=USD&apikey=YOUR_KEY
+GET /query?function=FX_INTRADAY&from_symbol=EUR&to_symbol=USD&interval=5min&apikey=YOUR_KEY
+```
+
+---
+
+### 5. Cryptocurrency
+
+#### Real-Time Exchange Rate
+```
+GET /query?function=CURRENCY_EXCHANGE_RATE&from_currency=BTC&to_currency=USD&apikey=YOUR_KEY
+```
+
+#### Crypto Time Series
+```
+GET /query?function=DIGITAL_CURRENCY_DAILY&symbol=BTC&market=USD&apikey=YOUR_KEY
+GET /query?function=DIGITAL_CURRENCY_WEEKLY&symbol=BTC&market=USD&apikey=YOUR_KEY
+GET /query?function=DIGITAL_CURRENCY_MONTHLY&symbol=BTC&market=USD&apikey=YOUR_KEY
+```
+
+---
+
+### 6. Technical Indicators
+```
+GET /query?function={INDICATOR}&symbol={symbol}&interval={interval}&time_period={n}&series_type={type}&apikey={key}
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `function` | Yes | Indicator name (see list below) |
+| `symbol` | Yes | Ticker symbol |
+| `interval` | Yes | `1min`, `5min`, `15min`, `30min`, `60min`, `daily`, `weekly`, `monthly` |
+| `time_period` | Yes* | Number of data points for calculation (e.g., 14 for RSI) |
+| `series_type` | Yes* | `close`, `open`, `high`, `low` |
+
+*Required for most indicators; some (like MACD, BBANDS) have additional parameters.
+
+**Common Indicator Functions:**
+`SMA`, `EMA`, `WMA`, `DEMA`, `TEMA`, `VWAP`, `RSI`, `MACD`, `STOCH`, `ADX`, `CCI`, `AROON`, `BBANDS`, `AD`, `OBV`, `ATR`, `WILLR`, `MOM`
+
+**Example -- RSI (14-day):**
+```
+https://www.alphavantage.co/query?function=RSI&symbol=AAPL&interval=daily&time_period=14&series_type=close&apikey=YOUR_KEY
+```
+
+**Example -- MACD:**
+```
+https://www.alphavantage.co/query?function=MACD&symbol=AAPL&interval=daily&series_type=close&apikey=YOUR_KEY
+```
+
+---
+
+### 7. Fundamental Data
+
+#### Company Overview
+```
+GET /query?function=OVERVIEW&symbol=AAPL&apikey=YOUR_KEY
+```
+Returns: market cap, PE ratio, EPS, dividend yield, 52-week high/low, sector, description, and ~60 other fields.
+
+#### Income Statement
+```
+GET /query?function=INCOME_STATEMENT&symbol=AAPL&apikey=YOUR_KEY
+```
+
+#### Balance Sheet
+```
+GET /query?function=BALANCE_SHEET&symbol=AAPL&apikey=YOUR_KEY
+```
+
+#### Cash Flow
+```
+GET /query?function=CASH_FLOW&symbol=AAPL&apikey=YOUR_KEY
+```
+
+#### Earnings
+```
+GET /query?function=EARNINGS&symbol=AAPL&apikey=YOUR_KEY
+```
+
+Returns both annual and quarterly earnings (EPS, estimated EPS, surprise).
+
+---
+
+### 8. Commodities & Economic Indicators
+```
+GET /query?function=WTI&interval=monthly&apikey=YOUR_KEY
+GET /query?function=BRENT&interval=monthly&apikey=YOUR_KEY
+GET /query?function=NATURAL_GAS&interval=monthly&apikey=YOUR_KEY
+GET /query?function=COPPER&interval=monthly&apikey=YOUR_KEY
+GET /query?function=ALUMINUM&interval=monthly&apikey=YOUR_KEY
+GET /query?function=WHEAT&interval=monthly&apikey=YOUR_KEY
+GET /query?function=CORN&interval=monthly&apikey=YOUR_KEY
+GET /query?function=COTTON&interval=monthly&apikey=YOUR_KEY
+GET /query?function=SUGAR&interval=monthly&apikey=YOUR_KEY
+GET /query?function=COFFEE&interval=monthly&apikey=YOUR_KEY
+```
+
+Economic indicators:
+```
+GET /query?function=REAL_GDP&interval=quarterly&apikey=YOUR_KEY
+GET /query?function=CPI&interval=monthly&apikey=YOUR_KEY
+GET /query?function=INFLATION&apikey=YOUR_KEY
+GET /query?function=RETAIL_SALES&apikey=YOUR_KEY
+GET /query?function=UNEMPLOYMENT&apikey=YOUR_KEY
+GET /query?function=FEDERAL_FUNDS_RATE&interval=monthly&apikey=YOUR_KEY
+GET /query?function=TREASURY_YIELD&interval=monthly&maturity=10year&apikey=YOUR_KEY
+```
+
+---
+
+## Notes
+- All values are returned as strings in JSON.
+- JSON keys use numbered prefixes (e.g., `"1. open"`, `"2. high"`).
+- Time series data is keyed by date/timestamp strings, not arrays.
+- When rate limited, the API returns: `{"Note": "Thank you for using Alpha Vantage! ..."}`
+- For `outputsize=full`, daily data goes back 20+ years.
+- The `datatype=csv` option returns simpler CSV output for any endpoint.
+- Free tier is very restrictive (25/day). For production use, a premium key is recommended.

package/skills/scientific/database-lookup/references/bea.md

@@ -0,0 +1,409 @@
+# BEA (Bureau of Economic Analysis) API Reference
+
+## Overview
+The Bureau of Economic Analysis API provides access to U.S. economic accounts data including GDP (national income and product accounts -- NIPA), personal income, international trade, industry accounts, and regional economic data. Structured as a single endpoint with dataset-specific parameters.
+
+## Base URL
+```
+https://apps.bea.gov/api/data
+```
+
+## Authentication
+- **API Key: REQUIRED.** Register at https://apps.bea.gov/API/signup/
+- Pass as query parameter: `&UserID=YOUR_API_KEY`
+
+## Rate Limits
+- **100 requests per minute** per API key.
+- **100 MB of data per minute** per API key.
+- **30 errors per minute** -- exceeding triggers a temporary lockout.
+- Daily and monthly limits are not formally published but BEA may throttle heavy use.
+
+## Common Parameters (all requests)
+| Parameter  | Type   | Required | Description |
+|-----------|--------|----------|-------------|
+| `UserID`  | string | Yes      | Your BEA API key. |
+| `method`  | string | Yes      | API method (see below). |
+| `ResultFormat` | string | No  | `JSON` (default) or `XML`. |
+
+---
+
+## Methods
+
+### 1. GetDataSetList
+Lists all available datasets.
+
+#### `GET /api/data?method=GetDataSetList&UserID=YOUR_KEY&ResultFormat=JSON`
+
+**Example:**
+```
+https://apps.bea.gov/api/data?method=GetDataSetList&UserID=YOUR_KEY&ResultFormat=JSON
+```
+
+**Response:**
+```json
+{
+  "BEAAPI": {
+    "Request": {
+      "RequestParam": [
+        {"ParameterName": "METHOD", "ParameterValue": "GETDATASETLIST"},
+        {"ParameterName": "RESULTFORMAT", "ParameterValue": "JSON"}
+      ]
+    },
+    "Results": {
+      "Dataset": [
+        {"DatasetName": "NIPA", "DatasetDescription": "Standard NIPA tables"},
+        {"DatasetName": "NIUnderlyingDetail", "DatasetDescription": "National Income and Product Accounts Underlying Detail"},
+        {"DatasetName": "MNE", "DatasetDescription": "Multinational Enterprises"},
+        {"DatasetName": "FixedAssets", "DatasetDescription": "Fixed Assets"},
+        {"DatasetName": "ITA", "DatasetDescription": "International Transactions"},
+        {"DatasetName": "IIP", "DatasetDescription": "International Investment Position"},
+        {"DatasetName": "GDPbyIndustry", "DatasetDescription": "GDP by Industry"},
+        {"DatasetName": "Regional", "DatasetDescription": "Regional data"},
+        {"DatasetName": "UnderlyingGDPbyIndustry", "DatasetDescription": "Underlying GDP by Industry"},
+        {"DatasetName": "InputOutput", "DatasetDescription": "Input-Output Statistics"}
+      ]
+    }
+  }
+}
+```
+
+---
+
+### 2. GetParameterList
+Lists parameters for a specific dataset.
+
+#### `GET /api/data?method=GetParameterList&DatasetName={dataset}&UserID=YOUR_KEY&ResultFormat=JSON`
+
+**Example:**
+```
+https://apps.bea.gov/api/data?method=GetParameterList&DatasetName=NIPA&UserID=YOUR_KEY&ResultFormat=JSON
+```
+
+**Response:**
+```json
+{
+  "BEAAPI": {
+    "Results": {
+      "Parameter": [
+        {
+          "ParameterName": "TableName",
+          "ParameterDataType": "string",
+          "ParameterDescription": "The standard NIPA table identifier",
+          "ParameterIsRequiredFlag": "1",
+          "ParameterDefaultValue": ""
+        },
+        {
+          "ParameterName": "Frequency",
+          "ParameterDataType": "string",
+          "ParameterDescription": "A - Annual, Q - Quarterly, M - Monthly",
+          "ParameterIsRequiredFlag": "1",
+          "ParameterDefaultValue": ""
+        },
+        {
+          "ParameterName": "Year",
+          "ParameterDataType": "string",
+          "ParameterDescription": "List of year(s) of data to retrieve",
+          "ParameterIsRequiredFlag": "1",
+          "ParameterDefaultValue": ""
+        }
+      ]
+    }
+  }
+}
+```
+
+---
+
+### 3. GetParameterValues
+Lists valid values for a parameter.
+
+#### `GET /api/data?method=GetParameterValues&DatasetName={dataset}&ParameterName={param}&UserID=YOUR_KEY&ResultFormat=JSON`
+
+**Example (list NIPA tables):**
+```
+https://apps.bea.gov/api/data?method=GetParameterValues&DatasetName=NIPA&ParameterName=TableName&UserID=YOUR_KEY&ResultFormat=JSON
+```
+
+**Response (abbreviated):**
+```json
+{
+  "BEAAPI": {
+    "Results": {
+      "ParamValue": [
+        {"TableName": "T10101", "Description": "Table 1.1.1. Percent Change From Preceding Period in Real Gross Domestic Product"},
+        {"TableName": "T10106", "Description": "Table 1.1.6. Real Gross Domestic Product, Chained Dollars"},
+        {"TableName": "T10105", "Description": "Table 1.1.5. Gross Domestic Product"},
+        {"TableName": "T20100", "Description": "Table 2.1. Personal Income and Its Disposition"},
+        {"TableName": "T30100", "Description": "Table 3.1. Government Current Receipts and Expenditures"}
+      ]
+    }
+  }
+}
+```
+
+---
+
+### 4. GetData
+The main data retrieval method. Parameters vary by dataset.
+
+#### `GET /api/data?method=GetData&DatasetName={dataset}&{params}&UserID=YOUR_KEY&ResultFormat=JSON`
+
+---
+
+## Dataset-Specific Parameters & Examples
+
+### A. NIPA (National Income and Product Accounts)
+
+**Parameters:**
+| Parameter   | Type   | Required | Description |
+|------------|--------|----------|-------------|
+| `TableName`| string | Yes      | NIPA table identifier (e.g., `T10101`). |
+| `Frequency`| string | Yes      | `A` (annual), `Q` (quarterly), `M` (monthly). |
+| `Year`     | string | Yes      | Comma-separated years, or `ALL`, or `X` for latest. |
+
+**Example (Real GDP percent change, quarterly, 2022-2024):**
+```
+https://apps.bea.gov/api/data?method=GetData&DatasetName=NIPA&TableName=T10101&Frequency=Q&Year=2022,2023,2024&UserID=YOUR_KEY&ResultFormat=JSON
+```
+
+**Example (GDP levels, annual, all years):**
+```
+https://apps.bea.gov/api/data?method=GetData&DatasetName=NIPA&TableName=T10105&Frequency=A&Year=ALL&UserID=YOUR_KEY&ResultFormat=JSON
+```
+
+**Response:**
+```json
+{
+  "BEAAPI": {
+    "Request": { ... },
+    "Results": {
+      "Statistic": "NIPA Table",
+      "UTCProductionTime": "2024-11-01T13:00:00.000",
+      "Dimensions": [
+        {"Name": "TableName", "DataType": "string", "IsValue": "0"},
+        {"Name": "SeriesCode", "DataType": "string", "IsValue": "0"},
+        {"Name": "LineNumber", "DataType": "numeric", "IsValue": "0"},
+        {"Name": "LineDescription", "DataType": "string", "IsValue": "0"},
+        {"Name": "TimePeriod", "DataType": "string", "IsValue": "0"},
+        {"Name": "METRIC_NAME", "DataType": "string", "IsValue": "0"},
+        {"Name": "CL_UNIT", "DataType": "string", "IsValue": "0"},
+        {"Name": "UNIT_MULT", "DataType": "numeric", "IsValue": "0"},
+        {"Name": "DataValue", "DataType": "numeric", "IsValue": "1"}
+      ],
+      "Data": [
+        {
+          "TableName": "T10101",
+          "SeriesCode": "A191RL",
+          "LineNumber": "1",
+          "LineDescription": "Gross domestic product",
+          "TimePeriod": "2022Q1",
+          "METRIC_NAME": "Fisher Quantity Index",
+          "CL_UNIT": "Percent change",
+          "UNIT_MULT": "0",
+          "DataValue": "-1.6",
+          "NoteRef": "T10101"
+        },
+        {
+          "TableName": "T10101",
+          "SeriesCode": "A191RL",
+          "LineNumber": "1",
+          "LineDescription": "Gross domestic product",
+          "TimePeriod": "2022Q2",
+          "CL_UNIT": "Percent change",
+          "DataValue": "-0.6"
+        }
+      ],
+      "Notes": [
+        {"NoteRef": "T10101", "NoteText": "Table 1.1.1. Percent Change From Preceding Period..."}
+      ]
+    }
+  }
+}
+```
+
+---
+
+### B. Regional (State, County, MSA data)
+
+**Parameters:**
+| Parameter     | Type   | Required | Description |
+|--------------|--------|----------|-------------|
+| `TableName`  | string | Yes      | Regional table (e.g., `CAGDP1` for GDP by state). |
+| `LineCode`   | int    | Yes      | Line number within the table (specifies the data series). |
+| `GeoFips`    | string | Yes      | FIPS code: `STATE` (all states), `COUNTY` (all counties), `MSA` (all MSAs), or specific FIPS (e.g., `06000` for California). |
+| `Year`       | string | Yes      | Comma-separated years or `ALL` or `LAST5`. |
+
+**Common Regional Tables:**
+| Table | Description |
+|-------|-------------|
+| `CAGDP1` | GDP summary by state |
+| `CAGDP2` | GDP by component by state |
+| `CAGDP9` | Real GDP by state |
+| `CAINC1` | Personal income summary by state |
+| `CAINC4` | Personal income and employment by state |
+| `CAINC5N` | Personal income by type by state |
+| `SAINC1` | State annual personal income |
+| `SQINC1` | State quarterly personal income |
+
+**Example (GDP by state, all states, 2020-2023):**
+```
+https://apps.bea.gov/api/data?method=GetData&DatasetName=Regional&TableName=CAGDP1&LineCode=1&GeoFips=STATE&Year=2020,2021,2022,2023&UserID=YOUR_KEY&ResultFormat=JSON
+```
+
+**Example (Personal income for California):**
+```
+https://apps.bea.gov/api/data?method=GetData&DatasetName=Regional&TableName=CAINC1&LineCode=1&GeoFips=06000&Year=LAST5&UserID=YOUR_KEY&ResultFormat=JSON
+```
+
+**Response:**
+```json
+{
+  "BEAAPI": {
+    "Results": {
+      "Data": [
+        {
+          "GeoFips": "06000",
+          "GeoName": "California",
+          "Code": "CAINC1-1",
+          "TimePeriod": "2023",
+          "CL_UNIT": "Thousands of dollars",
+          "UNIT_MULT": "3",
+          "DataValue": "3,220,965,123"
+        }
+      ]
+    }
+  }
+}
+```
+
+---
+
+### C. ITA (International Transactions Accounts / Trade)
+
+**Parameters:**
+| Parameter    | Type   | Required | Description |
+|-------------|--------|----------|-------------|
+| `Indicator` | string | Yes      | Indicator code (e.g., `BalGds` for goods balance). |
+| `AreaOrCountry` | string | Yes  | Country code: `AllCountries`, `China`, `Japan`, etc., or `All`. |
+| `Frequency` | string | Yes      | `A`, `Q`, `M`. |
+| `Year`      | string | Yes      | Comma-separated years or `ALL`. |
+
+**Common ITA Indicators:**
+| Code | Description |
+|------|-------------|
+| `BalGds` | Balance on goods |
+| `BalServ` | Balance on services |
+| `BalGdsServ` | Balance on goods and services |
+| `BalCurAcct` | Current account balance |
+| `ExpGds` | Exports of goods |
+| `ImpGds` | Imports of goods |
+| `ExpServ` | Exports of services |
+| `ImpServ` | Imports of services |
+
+**Example (US trade balance in goods with China, quarterly):**
+```
+https://apps.bea.gov/api/data?method=GetData&DatasetName=ITA&Indicator=BalGds&AreaOrCountry=China&Frequency=Q&Year=2022,2023,2024&UserID=YOUR_KEY&ResultFormat=JSON
+```
+
+---
+
+### D. GDPbyIndustry
+
+**Parameters:**
+| Parameter    | Type   | Required | Description |
+|-------------|--------|----------|-------------|
+| `TableID`   | int    | Yes      | Table number (1-15). |
+| `Industry`  | string | Yes      | Industry code: `ALL`, or specific (e.g., `11` for agriculture). |
+| `Frequency` | string | Yes      | `A` or `Q`. |
+| `Year`      | string | Yes      | Comma-separated years or `ALL`. |
+
+**Common Table IDs:**
+| ID | Description |
+|----|-------------|
+| 1  | Value added by industry |
+| 5  | Value added by industry as % of GDP |
+| 6  | Real value added by industry |
+| 7  | Percent change in real value added by industry |
+
+**Example (Value added by all industries, annual):**
+```
+https://apps.bea.gov/api/data?method=GetData&DatasetName=GDPbyIndustry&TableID=1&Industry=ALL&Frequency=A&Year=2020,2021,2022,2023&UserID=YOUR_KEY&ResultFormat=JSON
+```
+
+---
+
+### E. IIP (International Investment Position)
+
+**Parameters:**
+| Parameter       | Type   | Required | Description |
+|----------------|--------|----------|-------------|
+| `TypeOfInvestment` | string | Yes  | `ALL`, `FinAssetsExclFinDeriv`, etc. |
+| `Component`    | string | Yes      | `ALL` or specific component. |
+| `Frequency`    | string | Yes      | `A` or `Q`. |
+| `Year`         | string | Yes      | Comma-separated years or `ALL`. |
+
+**Example:**
+```
+https://apps.bea.gov/api/data?method=GetData&DatasetName=IIP&TypeOfInvestment=ALL&Component=ALL&Frequency=A&Year=2020,2021,2022,2023&UserID=YOUR_KEY&ResultFormat=JSON
+```
+
+---
+
+### F. FixedAssets
+
+**Parameters:**
+| Parameter   | Type   | Required | Description |
+|------------|--------|----------|-------------|
+| `TableName`| string | Yes      | Fixed asset table ID. |
+| `Year`     | string | Yes      | Comma-separated years or `ALL`. |
+
+**Example:**
+```
+https://apps.bea.gov/api/data?method=GetData&DatasetName=FixedAssets&TableName=FAAt101&Year=ALL&UserID=YOUR_KEY&ResultFormat=JSON
+```
+
+---
+
+## Key NIPA Table Reference
+
+| TableName | Description |
+|-----------|-------------|
+| `T10101` | Percent change in real GDP |
+| `T10105` | GDP (current dollars) |
+| `T10106` | Real GDP (chained 2017 dollars) |
+| `T10107` | GDP price index (percent change) |
+| `T10110` | GDP price deflator |
+| `T20100` | Personal income and its disposition |
+| `T20301` | Personal consumption expenditures by type |
+| `T20600` | Personal income and outlays |
+| `T30100` | Government current receipts and expenditures |
+| `T40100` | Foreign transactions in the national accounts |
+| `T50100` | Saving and investment by sector |
+| `T50105` | Saving and investment (real) |
+| `T60100` | Corporate profits |
+| `T70100` | GDP by major type of product |
+| `T11000` | Real GDP, expanded detail |
+| `T11200` | Contributions to GDP growth |
+
+## GeoFips Reference (Common)
+| FIPS | State |
+|------|-------|
+| `00000` | United States |
+| `01000` | Alabama |
+| `06000` | California |
+| `12000` | Florida |
+| `36000` | New York |
+| `48000` | Texas |
+| `STATE` | All states |
+| `COUNTY` | All counties |
+| `MSA` | All metropolitan statistical areas |
+
+## Notes
+- DataValue in responses is a string, sometimes with commas (e.g., `"3,220,965,123"`). Parse by removing commas.
+- `Year=X` returns only the most recent year available.
+- `Year=LAST5` returns the 5 most recent years.
+- For NIPA tables, results contain multiple line items per table (different GDP components are different LineNumbers).
+- The `GetParameterValues` method is essential for discovering valid table names, line codes, and indicator codes for each dataset.
+- BEA also provides bulk download files at https://apps.bea.gov/iTable/ for interactive use.
+- Time periods for quarterly data use format `2024Q1`, `2024Q2`, etc.
+- All monetary values are in U.S. dollars unless otherwise specified. Units are indicated in `CL_UNIT` and `UNIT_MULT` fields.