# Alpha Vantage

Alpha Vantage provides free APIs for real-time and historical financial data, including stock time series, technical indicators, and more.

- **Category:** analytics
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 56
- **Triggers:** 0
- **Slug:** `ALPHA_VANTAGE`
- **Version:** 20260316_00

## Tools

### Get All Commodities Price Index

**Slug:** `ALPHA_VANTAGE_ALL_COMMODITIES`

Tool to retrieve the global price index of all commodities. Use when you need monthly, quarterly, or annual aggregated price index data for commodities.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datatype` | string ("json" | "csv") | No | Output format: 'json' for JSON response, 'csv' for CSV text. |
| `interval` | string ("monthly" | "quarterly" | "annual") | Yes | Time interval for the global commodities price index. Supported values: 'monthly', 'quarterly', 'annual'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### ALUMINUM

**Slug:** `ALPHA_VANTAGE_ALUMINUM`

Tool to fetch global aluminum prices. Use when you need monthly, quarterly, or annual LME aluminum price data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datatype` | string | No | Response format |
| `interval` | string ("monthly" | "quarterly" | "annual") | No | Time horizon for aluminum prices |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Balance Sheet

**Slug:** `ALPHA_VANTAGE_BALANCE_SHEET`

Tool to return annual and quarterly balance sheets for a company. Use when you need detailed fiscal statements for analysis. Numeric fields may be returned as strings or empty values; treat empty/missing fields as null, not zero, before performing calculations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbol` | string | Yes | The stock ticker symbol of the company, e.g., 'IBM' Data completeness varies by symbol; missing fields indicate absent data, not zero. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Brent Crude Oil Prices

**Slug:** `ALPHA_VANTAGE_BRENT`

Tool to fetch Brent crude oil prices. Use when you need daily, weekly, or monthly Brent price data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datatype` | string ("json" | "csv") | No | Output format. Defaults to 'json'. |
| `interval` | string ("daily" | "weekly" | "monthly") | No | Time series interval. Defaults to 'monthly'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cash Flow

**Slug:** `ALPHA_VANTAGE_CASH_FLOW`

Tool to return annual and quarterly cash flow statements for a company. Use when you need to analyze cash movements.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbol` | string | Yes | The stock ticker symbol of the company, e.g., 'IBM' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Global Coffee Price

**Slug:** `ALPHA_VANTAGE_COFFEE`

Tool to retrieve the global coffee price series. Use when you need historical monthly, quarterly, or annual coffee prices.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datatype` | string ("json" | "csv") | No | Response format: json or csv. |
| `interval` | string ("monthly" | "quarterly" | "annual") | No | Time resolution: monthly, quarterly, or annual. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Company Overview (Stocks Only)

**Slug:** `ALPHA_VANTAGE_COMPANY_OVERVIEW`

Tool to retrieve company overview and fundamental data for individual company stocks. Note: This endpoint only works for stocks, not ETFs, mutual funds, or indices. Use after specifying a valid stock ticker symbol. Numeric fields (e.g., MarketCapitalization, SharesOutstanding, Beta, DividendYield, PERatio) are returned as strings and may be empty — treat empty/missing values as null, not zero. Fundamentals such as Beta, PERatio, and PayoutRatio may reflect different reporting periods across symbols; avoid naive cross-symbol aggregation without aligning periods. Check the as-of date in the response; SharesOutstanding and similar fields can lag corporate actions. Alpha Vantage enforces per-minute and per-day rate caps; throttle requests when processing bulk symbol lists.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `symbol` | string | Yes | Ticker symbol for an individual company stock (e.g., 'IBM'). Note: This endpoint only works for stocks, not ETFs, mutual funds, or indices. Small-cap and non-US listings may return partial or incomplete data; validate coverage before computing metrics. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### COPPER

**Slug:** `ALPHA_VANTAGE_COPPER`

Tool to fetch global price of copper in monthly, quarterly, and annual intervals. Use when you need historical copper price series for analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datatype` | string ("json" | "csv") | No | Response format: json or csv |
| `interval` | string ("monthly" | "quarterly" | "annual") | No | Time horizon for copper prices |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Corn

**Slug:** `ALPHA_VANTAGE_CORN`

Tool to retrieve global price of corn in monthly, quarterly, and annual intervals. Use after verifying API key when you need historical Corn price data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datatype` | string ("json" | "csv") | No | Output format of the data. |
| `interval` | string ("monthly" | "quarterly" | "annual") | No | Time interval between data points. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### COTTON

**Slug:** `ALPHA_VANTAGE_COTTON`

Tool to retrieve global cotton prices in monthly, quarterly, and annual intervals. Use when you need historical cotton price data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datatype` | string ("json" | "csv") | No | Format of the returned data. |
| `interval` | string ("monthly" | "quarterly" | "annual") | No | Time interval between data points. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Consumer Price Index (CPI)

**Slug:** `ALPHA_VANTAGE_CPI`

Tool to fetch monthly and semiannual Consumer Price Index (CPI) data of the United States. Use when you need inflation metrics or CPI historical data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `datatype` | string ("json" | "csv") | No | Output format: 'json' for JSON response or 'csv' for CSV. Defaults to 'json'. |
| `interval` | string ("monthly" | "semiannual") | No | Data interval: 'monthly' for monthly CPI or 'semiannual' for semiannual CPI. Defaults to 'monthly'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Crypto Intraday Time Series

**Slug:** `ALPHA_VANTAGE_CRYPTO_INTRADAY`

Tool to retrieve intraday time series data for cryptocurrencies with realtime updates. Use when you need high-frequency OHLCV data (open, high, low, close, volume) for a specific cryptocurrency/market pair within the trading day.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `market` | string | Yes | The exchange market currency (e.g., 'USD', 'EUR'). Must be from the Alpha Vantage market list. |
| `symbol` | string | Yes | The digital/crypto currency symbol (e.g., 'BTC', 'ETH'). Must be from the Alpha Vantage digital currency list. |
| `datatype` | string ("json" | "csv") | No | Response format: 'json' (default) or 'csv'. Note: CSV format is not supported by this action. |
| `interval` | string ("1min" | "5min" | "15min" | "30min" | "60min") | Yes | Time interval between two consecutive data points in the time series. Supported values: '1min', '5min', '15min', '30min', '60min'. |
| `outputsize` | string ("compact" | "full") | No | Output size: 'compact' returns the latest 100 data points; 'full' returns the full-length intraday time series. Defaults to 'compact'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Currency Exchange Rate

**Slug:** `ALPHA_VANTAGE_CURRENCY_EXCHANGE_RATE`

Tool to retrieve real-time exchange rate for a currency pair. Use after confirming base and quote currency codes to get current rates. Rate is nested at response['Realtime Currency Exchange Rate']['5. Exchange Rate'] as a string; cast to float before calculations. Treat missing key or '0.00000000' as unavailable. On free-tier keys, throttling returns HTTP 200 with 'Information' or 'Note' field instead of data — inspect response body before parsing. Free-tier limits: ~5 requests/minute, ~25 requests/day. For historical or intraday data use ALPHA_VANTAGE_FX_DAILY or TWELVE_DATA_TIME_SERIES.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Optional API key to override metadata (e.g., 'demo'). |
| `to_currency` | string | Yes | The quote currency code in three-letter format. Supports physical currencies (e.g., 'USD', 'EUR', 'JPY') and cryptocurrencies (e.g., 'BTC', 'ETH'). Note: Precious metal codes like XAU (gold) and XAG (silver) are NOT supported by this endpoint. |
| `from_currency` | string | Yes | The base currency code in three-letter format. Supports physical currencies (e.g., 'USD', 'EUR', 'JPY') and cryptocurrencies (e.g., 'BTC', 'ETH'). Note: Precious metal codes like XAU (gold) and XAG (silver) are NOT supported by this endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Digital Currency Daily Time Series

**Slug:** `ALPHA_VANTAGE_DIGITAL_CURRENCY_DAILY`

Tool to retrieve daily historical time series for a digital currency traded on a specific market. Use when needing daily OHLC and volume data for a crypto/fiat pair, refreshed daily at midnight UTC.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `market` | string | Yes | Market currency (to-currency) from Alpha Vantage list, e.g., 'USD'. |
| `symbol` | string | Yes | Cryptocurrency symbol (from-currency) from Alpha Vantage list, e.g., 'BTC'. |
| `datatype` | string | No | The format of the output. Defaults to 'json'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Digital Currency Monthly Time Series

**Slug:** `ALPHA_VANTAGE_DIGITAL_CURRENCY_MONTHLY`

Tool to retrieve monthly digital currency prices in a fiat currency. Use when needing long-term monthly OHLC and volume data for a given crypto/fiat pair. Always returns full history; no date range filtering — filter client-side. OHLCV response values are strings; convert to numeric types before calculations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `market` | string | Yes | Market currency (to-currency) from Alpha Vantage list, e.g., 'EUR'. |
| `symbol` | string | Yes | Cryptocurrency symbol (from-currency) from Alpha Vantage list, e.g., 'BTC'. |
| `datatype` | string ("json" | "csv") | No | The format of the output: 'json' or 'csv'. Defaults to 'json'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Digital Currency Weekly Time Series

**Slug:** `ALPHA_VANTAGE_DIGITAL_CURRENCY_WEEKLY`

Tool to retrieve weekly digital currency prices in a fiat currency. Use when needing weekly OHLC and volume data for a given crypto/fiat pair.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `market` | string | Yes | Market currency (to-currency) from Alpha Vantage list, e.g., 'USD'. |
| `symbol` | string | Yes | Cryptocurrency symbol (from-currency) from Alpha Vantage list, e.g., 'BTC'. |
| `datatype` | string ("json" | "csv") | No | The format of the output: 'json' or 'csv'. Defaults to 'json'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Durable Goods Orders

**Slug:** `ALPHA_VANTAGE_DURABLES`

Tool to fetch monthly manufacturers' new orders of durable goods data for the United States. Use when you need historical data on big-ticket consumer purchases like cars, appliances, and refrigerators.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `datatype` | string ("json" | "csv") | No | Output format: 'json' for JSON response or 'csv' for CSV. Defaults to 'json'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Earnings

**Slug:** `ALPHA_VANTAGE_EARNINGS`

Tool to retrieve annual and quarterly earnings (EPS history) for a specific company symbol. Free tier limit: ~25 requests/day, 1 request/second; an 'Information' key or empty array in the response indicates rate limit exhaustion or missing data — avoid parallel calls.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `symbol` | string | Yes | Stock ticker symbol for a publicly traded company (e.g., 'IBM', 'AAPL', 'MSFT'). Must be a valid ticker symbol, not a URL or other format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Earnings Calendar

**Slug:** `ALPHA_VANTAGE_EARNINGS_CALENDAR`

Tool to return the earnings calendar for the next three months. Use when you need a schedule of upcoming earnings across symbols. Returned dates reflect local exchange time, not UTC; normalize to UTC before comparing against the horizon window.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbol` | string | No | (Optional) Ticker symbol to filter the earnings calendar, e.g., 'IBM'. Omitting this filter returns all symbols and can produce a very large response. |
| `horizon` | string ("3month" | "6month" | "12month") | No | Time horizon to return upcoming earnings within. Valid values: '3month', '6month', '12month'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Earnings Call Transcript

**Slug:** `ALPHA_VANTAGE_EARNINGS_CALL_TRANSCRIPT`

Tool to retrieve the earnings call transcript for a given company and quarter. Use after confirming symbol and quarter. Returns full transcript text and associated LLM-based sentiment signals. Transcripts may be unavailable for some quarters; verify available periods via ALPHA_VANTAGE_EARNINGS if response is empty. Free tier: ~25 requests/day, ~1 request/second — empty arrays or 'Information' messages may indicate rate limits rather than missing data; space out requests and avoid parallel calls. Transcripts can be very long; chunk or extract key sections before passing to an LLM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbol` | string | Yes | The stock ticker symbol, e.g., 'IBM'. |
| `quarter` | string | Yes | Fiscal quarter in YYYYQn format, e.g., '2024Q1'. Any quarter since 2010Q1 is supported. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Federal Funds Rate

**Slug:** `ALPHA_VANTAGE_FEDERAL_FUNDS_RATE`

Tool to fetch daily, weekly, and monthly federal funds rate data of the United States. Use when you need historical interest rate data from the US Federal Reserve for economic analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `interval` | string ("daily" | "weekly" | "monthly") | No | Time interval for the data. Allowed values: 'daily', 'weekly', 'monthly'. Determines the frequency of the federal funds rate data points. Defaults to 'monthly' if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### FX Daily Time Series

**Slug:** `ALPHA_VANTAGE_FX_DAILY`

Tool to fetch daily time series (open, high, low, close) for a currency pair. Use after confirming base and quote currency codes to retrieve historical daily FX rates. Response keys are timestamp strings and are not guaranteed to be sorted; always sort explicitly to find the most recent entry. Weekends and market holidays are excluded from the series.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datatype` | string | No | Return format. Only JSON is supported. Defaults to 'json'. |
| `to_symbol` | string | Yes | The quote currency code in three-letter ISO format (e.g., 'USD', 'EUR', 'JPY'). Note: Precious metal codes like XAU (gold) and XAG (silver) are NOT supported by this endpoint. |
| `outputsize` | string ("compact" | "full") | No | Return the latest 100 data points ('compact') or full-length time series ('full'). Defaults to 'compact'. Historical data availability is limited; 'full' output may be incomplete for very old date ranges. |
| `from_symbol` | string | Yes | The base currency code in three-letter ISO format (e.g., 'EUR', 'USD', 'GBP'). Note: Precious metal codes like XAU (gold) and XAG (silver) are NOT supported by this endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### FX Intraday Time Series

**Slug:** `ALPHA_VANTAGE_FX_INTRADAY`

Tool to retrieve intraday OHLC time series for a forex pair at 1-60 minute intervals (premium endpoint). Use when you need minute-bar FX data for backtesting or monitoring. Note: This is a premium Alpha Vantage function; check entitlement if errors occur.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datatype` | string | No | Return format. Only JSON is supported. Defaults to 'json'. |
| `interval` | string ("1min" | "5min" | "15min" | "30min" | "60min") | Yes | Time interval between data points. Must be one of: 1min, 5min, 15min, 30min, or 60min. |
| `to_symbol` | string | Yes | The quote currency code in three-letter ISO format (e.g., 'USD', 'EUR', 'JPY'). |
| `outputsize` | string ("compact" | "full") | No | Return the latest 100 data points ('compact') or full-length time series ('full'). Defaults to 'compact'. |
| `from_symbol` | string | Yes | The base currency code in three-letter ISO format (e.g., 'EUR', 'USD', 'GBP'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### FX Monthly Time Series

**Slug:** `ALPHA_VANTAGE_FX_MONTHLY`

Tool to get monthly time series (open, high, low, close) for a currency pair. Use when you need historical monthly forex data for a given currency pair. Data is returned in reverse-chronological order; OHLC values are strings and must be cast to numeric types before computations. The most recent entry may represent an incomplete period — treat its OHLC values as preliminary until the month closes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datatype` | string ("json" | "csv") | No | The format of the output. 'json' or 'csv'. Defaults to 'json'. |
| `to_symbol` | string | Yes | The quote currency code in three-letter ISO format (e.g., 'USD', 'EUR', 'CHF'). Must be a physical fiat currency from Alpha Vantage's supported list. |
| `from_symbol` | string | Yes | The base currency code in three-letter ISO format (e.g., 'EUR', 'GBP', 'JPY'). Must be a physical fiat currency from Alpha Vantage's supported list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### FX Weekly Time Series

**Slug:** `ALPHA_VANTAGE_FX_WEEKLY`

Tool to get weekly time series (open, high, low, close) for a currency pair. Use when you need weekly FX rates. Results are reverse-chronological; sort ascending and cast OHLC string values to numeric before computing indicators. The most recent entry may represent an incomplete week — treat its high, low, and close as provisional until the week closes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datatype` | string | No | The output format. Defaults to 'json'. |
| `to_symbol` | string | Yes | The quote currency code in three-letter ISO format, e.g., 'USD'. |
| `from_symbol` | string | Yes | The base currency code in three-letter ISO format, e.g., 'EUR'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Dividend History

**Slug:** `ALPHA_VANTAGE_GET_DIVIDENDS`

Tool to retrieve historical dividend payment records for a stock symbol. Use when you need dividend dates and amounts for analyzing company distributions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol to retrieve dividend history for, e.g., 'IBM' or 'AAPL' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Historical Options

**Slug:** `ALPHA_VANTAGE_GET_HISTORICAL_OPTIONS`

Tool to retrieve full historical options chain for a symbol on a specific date with 15+ years of history, including Greeks and IV. Use when you need historical options data with pricing, volume, and Greeks for analysis. Note: This is a premium Alpha Vantage endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Historical date in YYYY-MM-DD format for which to retrieve options chain data. Defaults to the previous trading session if not provided. Accepts any date later than 2008-01-01. |
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `symbol` | string | Yes | The equity symbol for which to retrieve historical options chain data (e.g., 'IBM', 'AAPL', 'TSLA'). |
| `datatype` | string | No | Response format: 'json' (default). Note: CSV format is not supported by this action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Analytics Sliding Window

**Slug:** `ALPHA_VANTAGE_GET_SLIDING_WINDOW_ANALYTICS`

Tool to retrieve advanced analytics metrics with sliding window calculations for trend analysis. Use when you need to perform statistical analysis on stock price movements over time, such as calculating moving averages, standard deviations, variances, or correlations between multiple stocks. Ideal for technical analysis and identifying trends.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ohlc` | string ("open" | "high" | "low" | "close") | No | Valid OHLC price types. |
| `RANGE` | string | Yes | Date range for analysis in YYYY-MM-DD format. Can be a single date (e.g., '2023-07-01') or two comma-separated dates for a range (e.g., '2023-01-01,2023-12-31'). The sliding window calculations will be performed over this time period. |
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `symbols` | string | Yes | Comma-separated list of stock symbols to analyze (e.g., 'IBM', 'AAPL,MSFT', 'TSLA,GOOGL,AMZN'). Multiple symbols allow for correlation and comparative analysis across stocks. |
| `interval` | string ("1min" | "5min" | "15min" | "30min" | "60min" | "DAILY" | "WEEKLY" | "MONTHLY") | Yes | Time interval between data points. Use intraday intervals (1min, 5min, 15min, 30min, 60min) for short-term analysis or period intervals (DAILY, WEEKLY, MONTHLY) for longer-term trend analysis. |
| `window_size` | integer | Yes | The size of the sliding window for calculations. This determines how many data points are included in each calculation window. For example, window_size=30 with DAILY interval means 30-day moving calculations. |
| `calculations` | string | Yes | Comma-separated list of statistical calculations to perform on the sliding window (e.g., 'MEAN', 'STDDEV', 'VARIANCE', 'CORRELATION'). Note: Free API keys may be limited to one calculation at a time. Common calculations include MEAN (average), STDDEV (standard deviation), VARIANCE, and CORRELATION (for multiple symbols). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Global Quote

**Slug:** `ALPHA_VANTAGE_GLOBAL_QUOTE`

Tool to retrieve latest price and volume information for a specified security ticker in realtime. Use when you need current stock quote data with price, volume, and daily trading metrics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `symbol` | string | Yes | The stock ticker symbol to retrieve quote data for, e.g., 'IBM', 'AAPL', 'TSLA'. Accepts only one symbol per call; retrieve multiple quotes with separate requests. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Income Statement

**Slug:** `ALPHA_VANTAGE_INCOME_STATEMENT`

Tool to fetch annual and quarterly income statements. Use after confirming the company symbol. Numeric fields may be returned as strings or empty values — convert safely and treat empty/missing as null, not zero, before computing derived metrics. Some symbols may be missing fields entirely; treat absent fields as missing data rather than defaults. One API call per symbol; when processing multiple symbols, retain only key derived fields rather than full raw responses.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol to retrieve income statements for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Inflation

**Slug:** `ALPHA_VANTAGE_INFLATION`

Tool to fetch annual U.S. inflation rates (consumer prices). Use when you need historical inflation data for economic analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `datatype` | string ("json" | "csv") | No | Output format: 'json' for JSON response or 'csv' for CSV. Defaults to 'json'. |
| `interval` | string ("annual" | "monthly" | "weekly" | "daily") | No | Data interval for the series. Valid values: 'annual', 'monthly', 'weekly', 'daily'. Note: INFLATION primarily returns annual data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### IPO Calendar

**Slug:** `ALPHA_VANTAGE_IPO_CALENDAR`

Tool to retrieve the IPO calendar for the next three months. Use when you need a list of upcoming IPO events across markets.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Listing Status

**Slug:** `ALPHA_VANTAGE_LISTING_STATUS`

Tool to fetch listing status of US stocks and ETFs. Use when you need active or delisted securities as of a date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Date to retrieve listing status (YYYY-MM-DD). Defaults to latest trading day. |
| `state` | string ("active" | "delisted") | No | Listing state: 'active' for current listings or 'delisted' for removed securities. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Market Status

**Slug:** `ALPHA_VANTAGE_MARKET_STATUS`

Tool to retrieve current market status (open/closed) for global stock exchanges. Use when you need to check if major trading venues worldwide are currently open or closed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Optional API key to override metadata (e.g., 'demo'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### News Sentiment

**Slug:** `ALPHA_VANTAGE_NEWS_SENTIMENT`

Tool to fetch live and historical market news & sentiment. Use when you need curated news articles with sentiment scores for specified tickers and topics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("LATEST" | "EARLIEST" | "RELEVANCE") | No | Sort order for articles: 'LATEST', 'EARLIEST', or 'RELEVANCE'. |
| `limit` | integer | No | Maximum number of articles to return (1-1000). Default is 50. For large result sets, articles may be returned in a remote/attached payload rather than inline — do not assume an inline preview contains all requested articles. |
| `topics` | array | No | List of topics to filter articles, e.g. ['technology','ipo']. Supported values are the topic literals. |
| `tickers` | string | No | Comma-separated tickers or asset identifiers to filter articles. Each ticker can only contain alphanumeric characters, colons, and underscores. Examples: 'AAPL', 'CRYPTO:BTC', 'FOREX:USD', 'AAPL,CRYPTO:BTC,FOREX:USD'. |
| `time_to` | string | No | End of time range (inclusive) in YYYYMMDDTHHMM format. If omitted, defaults to current time. |
| `time_from` | string | No | Start of time range (inclusive) in YYYYMMDDTHHMM format, e.g. '20220410T0130'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Nonfarm Payroll

**Slug:** `ALPHA_VANTAGE_NONFARM_PAYROLL`

Tool to fetch monthly U.S. nonfarm payroll employment data from the Bureau of Labor Statistics. Use when you need historical employment statistics for economic analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `datatype` | string | No | Output format. Only 'json' is supported. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Real GDP

**Slug:** `ALPHA_VANTAGE_REAL_GDP`

Tool to fetch U.S. real GDP time series. Use when you need quarterly or annual GDP data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `datatype` | string | No | Output format. Only 'json' is supported. |
| `interval` | string ("annual" | "quarterly") | No | Data interval: 'annual' for yearly GDP or 'quarterly' for quarterly GDP. Defaults to 'annual'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Real GDP Per Capita

**Slug:** `ALPHA_VANTAGE_REAL_GDP_PER_CAPITA`

Tool to fetch quarterly Real GDP per capita data of the United States. Use when you need real GDP per capita information adjusted for inflation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `datatype` | string | No | Output format. Only 'json' is supported. Defaults to 'json'. |
| `interval` | string ("annual" | "quarterly") | No | Data interval: 'annual' for yearly data or 'quarterly' for quarterly data. Defaults to 'annual'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Realtime Bulk Quotes

**Slug:** `ALPHA_VANTAGE_REALTIME_BULK_QUOTES`

Tool to retrieve realtime quotes for US-traded symbols in bulk (up to 100 symbols per request). Use when you need current price and volume data for multiple symbols simultaneously, covering both regular and extended trading hours. This is a premium API function requiring subscription. If subscription access is denied, use ALPHA_VANTAGE_GLOBAL_QUOTE for single-symbol quotes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Optional API key to override metadata (e.g., 'demo'). If not provided, uses the API key from metadata. |
| `symbol` | string | Yes | Up to 100 stock ticker symbols separated by comma (e.g., 'IBM,AAPL,MSFT'). This parameter accepts multiple symbols in a single request for bulk quote retrieval. No spaces around commas; 'IBM, AAPL' is invalid. |
| `datatype` | string ("json" | "csv") | No | Response format: 'json' (default) returns results in JSON format; 'csv' returns results as a comma separated value file. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retail Sales

**Slug:** `ALPHA_VANTAGE_RETAIL_SALES`

Tool to fetch monthly retail trade sales data of the United States. Use when you need historical U.S. retail sales statistics sourced from Census Bureau.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `datatype` | string | No | Output format: 'json' for JSON response. Defaults to 'json'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Sector Performance

**Slug:** `ALPHA_VANTAGE_SECTOR`

Tool to retrieve real-time and historical sector performance data. Use when you need sector performance metrics across timeframes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Stock Splits

**Slug:** `ALPHA_VANTAGE_SPLITS`

Tool to retrieve historical stock split events for a symbol. Use when you need past split dates and ratio details before analyzing corporate actions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol to retrieve split history for, e.g., 'IBM' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Global Sugar Price

**Slug:** `ALPHA_VANTAGE_SUGAR`

Tool to retrieve the global sugar price series. Use when you need historical monthly, quarterly, or annual sugar prices.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datatype` | string | No | Response format. Only 'json' is supported. |
| `interval` | string ("monthly" | "quarterly" | "annual") | No | Time resolution: monthly, quarterly, or annual. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Symbol Search

**Slug:** `ALPHA_VANTAGE_SYMBOL_SEARCH`

Tool to search for best-matching symbols based on keywords. Use when you need to find ticker symbols by a name or keyword. Returns multiple close matches — inspect the exchange, region, and currency fields in each result to select the correct symbol before passing it to downstream calls. Coverage excludes some exotic instruments and non-US assets; handle empty results explicitly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Optional API key to override metadata (e.g., 'demo'). Overrides the integration-level key; Alpha Vantage enforces per-minute and per-day rate limits across all endpoints, so throttle sequential calls accordingly. |
| `datatype` | string ("json" | "csv") | No | The format of the response: 'json' or 'csv'. Defaults to 'json'. |
| `keywords` | string | Yes | The keywords to search for symbols (e.g., 'microsoft'). Must be non-empty; blank or whitespace-only strings return no meaningful results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Technical Indicator

**Slug:** `ALPHA_VANTAGE_TECHNICAL_INDICATOR`

Tool to fetch technical indicators for the specified equity or currency pair. Use after obtaining time series to compute moving averages or oscillators. Response body may contain 'Information' or 'Note' keys indicating errors or rate-limit signals — inspect payload before treating data as valid. Results are nested under a function-specific key (e.g., 'Technical Analysis: RSI') with values as strings; convert to numeric before calculations. No date range filtering supported; returns all available data points — filter client-side to the required window.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `month` | string | No | Month (YYYY-MM) for intraday data; only for 1min–60min intervals. |
| `symbol` | string | Yes | Equity ticker or currency/crypto pair to analyze. Must be a valid stock ticker (e.g., 'IBM', 'AAPL') or currency/crypto pair (e.g., 'USDEUR', 'BTCUSD'). Alphanumeric characters only, no URLs or special characters. |
| `datatype` | string ("json" | "csv") | No | Output format: 'json' or 'csv'. |
| `function` | string | Yes | Technical indicator function name. E.g., 'SMA', 'MACD', 'RSI'. |
| `interval` | string ("1min" | "5min" | "15min" | "30min" | "60min" | "daily" | "weekly" | "monthly") | Yes | Time interval between data points. |
| `series_type` | string ("close" | "open" | "high" | "low") | Yes | Series to use for calculation (price type). |
| `time_period` | integer | Yes | Number of periods for indicator calculation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Time Series Daily

**Slug:** `ALPHA_VANTAGE_TIME_SERIES_DAILY`

Tool to retrieve daily time series data (date, daily open, high, low, close, volume) for a global equity symbol, covering 20+ years of historical data. Use when you need daily OHLCV data for a specific stock.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `symbol` | string | Yes | The stock ticker symbol. For US stocks, use the ticker only (e.g., 'IBM', 'MSFT', 'AAPL'). For international stocks, append the exchange suffix: '.LON' for London Stock Exchange (e.g., 'TSCO.LON'), '.TRT' for Toronto Stock Exchange (e.g., 'SHOP.TRT'), '.DEX' for XETRA Germany (e.g., 'MBG.DEX'), '.BSE' for Bombay Stock Exchange (e.g., 'RELIANCE.BSE'), '.SHH' for Shanghai Stock Exchange (e.g., '600104.SHH'), '.SHZ' for Shenzhen Stock Exchange (e.g., '000002.SHZ'). Note: Common Chinese exchange suffixes '.SH' and '.SZ' are automatically converted to '.SHH' and '.SHZ' respectively. Use the SYMBOL_SEARCH action to find valid symbols for any global stock. Do not pass URLs - just the ticker symbol itself. |
| `datatype` | string ("json" | "csv") | No | The format of the output: 'json' or 'csv'. Defaults to 'json'. Note: CSV format is not supported by this action. |
| `outputsize` | string | No | Output size: 'compact' returns the latest 100 data points. Note: 'full' output (20+ years of historical data) is only available with a premium Alpha Vantage subscription and is not supported by this action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Time Series Intraday

**Slug:** `ALPHA_VANTAGE_TIME_SERIES_INTRADAY`

Tool to retrieve intraday OHLCV for a given equity. Use when you need high-frequency pricing data within the trading day. Always inspect the JSON response body for 'Information' or 'Error Message' fields — the API may return these instead of data even on HTTP 200.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `month` | string | No | Specific month in 'YYYY-MM' format for historical intraday data; only for intraday intervals Very old dates may return no data; intraday history coverage is limited. |
| `symbol` | string | Yes | The stock ticker symbol. For US stocks, use the ticker only (e.g., 'IBM', 'MSFT', 'AAPL'). For international stocks, append the exchange suffix: '.LON' for London Stock Exchange (e.g., 'TSCO.LON'), '.TRT' for Toronto Stock Exchange (e.g., 'SHOP.TRT'), '.DEX' for XETRA Germany (e.g., 'MBG.DEX'), '.BSE' for Bombay Stock Exchange (e.g., 'RELIANCE.BSE'), '.SHH' for Shanghai Stock Exchange (e.g., '600104.SHH'), '.SHZ' for Shenzhen Stock Exchange (e.g., '000002.SHZ'). Do not pass URLs - just the ticker symbol itself. |
| `adjusted` | string ("true" | "false") | No | Return split/dividend-adjusted values ('true') or raw as-traded values ('false') |
| `datatype` | string ("json" | "csv") | No | Response format: 'json' (default) or 'csv' Response structure differs significantly between 'json' and 'csv' — ensure parsing logic matches the selected format. |
| `interval` | string ("1min" | "5min" | "15min" | "30min" | "60min") | Yes | Time interval between data points Accepted values: '1min', '5min', '15min', '30min', '60min' only. |
| `outputsize` | string ("compact" | "full") | No | Return latest 100 points ('compact') or full-length data ('full') Free-tier keys may return an 'Information' block instead of data when 'full' is requested. |
| `extended_hours` | string ("true" | "false") | No | Include pre/post-market data ('true') or only regular hours ('false') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Time Series Intraday Extended

**Slug:** `ALPHA_VANTAGE_TIME_SERIES_INTRADAY_EXTENDED`

Tool to retrieve historical intraday OHLCV data for the trailing 2 years, covering over 2 million data points per ticker. Use when you need extensive historical intraday pricing data for data visualization, trading simulation, backtesting, or machine learning applications with longer horizons.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `slice` | string | Yes | Specifies which 30-day window of data to retrieve from the trailing 2 years. Valid values: 'year1month1' (most recent), 'year1month2', ..., 'year1month12', 'year2month1', 'year2month2', ..., 'year2month12' (oldest) |
| `symbol` | string | Yes | Equity ticker symbol, e.g., 'IBM', 'AAPL', 'TSLA' |
| `adjusted` | string ("true" | "false") | No | When 'true' (default), output is adjusted by historical split and dividend events. Set to 'false' to query raw as-traded intraday values |
| `interval` | string ("1min" | "5min" | "15min" | "30min" | "60min") | Yes | Time interval between consecutive data points |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Time Series Monthly

**Slug:** `ALPHA_VANTAGE_TIME_SERIES_MONTHLY`

Tool to retrieve monthly open, high, low, close, and volume for a global equity. Use when you need month-end OHLCV data for a specific stock symbol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `symbol` | string | Yes | Equity ticker symbol to retrieve monthly data for, e.g., 'IBM'. |
| `datatype` | string ("json" | "csv") | No | The format of the output: 'json' or 'csv'. Defaults to 'json'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Monthly Adjusted Time Series

**Slug:** `ALPHA_VANTAGE_TIME_SERIES_MONTHLY_ADJUSTED`

Tool to retrieve monthly adjusted OHLC and volume for a global equity. Use after confirming the ticker symbol when you need end-of-month adjusted price and dividend data. Dividends are returned as a single aggregated value per month; annual or multi-year payout totals require manual summation across monthly data points.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `symbol` | string | Yes | Equity ticker symbol (e.g., 'IBM'). |
| `datatype` | string ("json" | "csv") | No | Return format. Only 'json' is supported. Defaults to 'json'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Weekly Time Series

**Slug:** `ALPHA_VANTAGE_TIME_SERIES_WEEKLY`

Tool to fetch weekly open, high, low, close, and volume for a global equity symbol. Use after confirming the target symbol to obtain its historical weekly OHLCV series. Alpha Vantage enforces per-minute and per-day rate limits; throttle sequential calls combining this tool with other time series or fundamentals endpoints.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `symbol` | string | Yes | Global equity symbol to retrieve weekly time series for, e.g., 'IBM'. Equity/FX-style symbols only (e.g., 'IBM', 'MSFT'); cryptocurrency symbols use a separate symbol/market pair format and are invalid here. |
| `datatype` | string ("json" | "csv") | No | Response format. JSON is supported; CSV is not supported. Defaults to 'json'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Weekly Adjusted Time Series

**Slug:** `ALPHA_VANTAGE_TIME_SERIES_WEEKLY_ADJUSTED`

Tool to fetch weekly adjusted time series data with split/dividend adjustments, covering 20+ years of historical data. Use after confirming the target symbol to obtain its historical weekly adjusted OHLCV series with dividend information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `symbol` | string | Yes | Global equity symbol to retrieve weekly adjusted time series for, e.g., 'IBM'. Accepts exactly one symbol per call; multiple symbols require separate calls. |
| `datatype` | string ("json" | "csv") | No | Response format. JSON is supported; CSV is not supported. Defaults to 'json'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Top Gainers, Losers & Most Active

**Slug:** `ALPHA_VANTAGE_TOP_GAINERS_LOSERS`

Tool to fetch the top 20 gainers, losers, and most actively traded US tickers. Use when you need current market movers data without maintaining a ticker universe. Data is updated end-of-day by default, with realtime/15-min delayed access available via premium.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Optional API key to override metadata (e.g., 'demo'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### US Treasury Yield

**Slug:** `ALPHA_VANTAGE_TREASURY_YIELD`

Tool to fetch US Treasury yield data for specified maturity and interval. Use when you need daily, weekly, or monthly treasury yield rates for various constant maturities (3-month, 2-year, 5-year, 7-year, 10-year, 30-year).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `interval` | string ("daily" | "weekly" | "monthly") | No | Time interval for the data. Allowed values: 'daily', 'weekly', 'monthly'. Determines the frequency of the treasury yield data points. |
| `maturity` | string ("3month" | "2year" | "5year" | "7year" | "10year" | "30year") | No | Tenor or constant maturity of the treasury yield. Allowed values: '3month', '2year', '5year', '7year', '10year', '30year'. Default is '10year' if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unemployment Rate

**Slug:** `ALPHA_VANTAGE_UNEMPLOYMENT`

Tool to fetch monthly unemployment rate data of the United States. Use when you need historical U.S. unemployment statistics sourced from Bureau of Labor Statistics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `apikey` | string | No | Override API key. If provided, this key is used instead of metadata's apikey. |
| `datatype` | string | No | Output format: 'json' for JSON response. Defaults to 'json'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### WHEAT

**Slug:** `ALPHA_VANTAGE_WHEAT`

Tool to fetch global price of wheat. Use when you need historical wheat prices in monthly, quarterly, or annual intervals.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datatype` | string ("json" | "csv") | No | Output format: json or csv |
| `interval` | string ("monthly" | "quarterly" | "annual") | No | Time horizon for wheat prices |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |