Alpha Vantage

56 tools available

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

analytics developer tools

Connect Alpha Vantage Visit Alpha Vantage ↗

Connect Alpha Vantage to Definable to answer ad-hoc analytics questions, detect anomalies, auto-generate weekly summaries. Personas call Alpha Vantage's 56 tools directly from chat or scheduled flows. Plug into a data-analysis persona to ask questions in plain English — the agent runs the queries.

Common workflows with Alpha Vantage

Weekly anomaly digest

Query metrics from this tool
Compare against rolling baseline
Surface anomalies with reasoning

Funnel deep-dive

Pull funnel events for a date range
Compute drop-offs at each step
Generate a written analysis

Cohort answers on demand

User asks a question in chat
Agent translates it to a query
Returns numbers + a chart-ready summary

Alpha Vantage actions 56

Every Alpha Vantage action below is a callable tool any Definable persona can invoke.

Get All Commodities Price Index

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

ALUMINUM

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

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.

Brent Crude Oil Prices

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

Cash Flow

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

Global Coffee Price

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

Company Overview (Stocks Only)

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.

COPPER

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

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.

COTTON

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

Consumer Price Index (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.

Crypto Intraday Time Series

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.

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.

Digital Currency Daily Time Series

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.

Digital Currency Monthly Time Series

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.

Digital Currency Weekly Time Series

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.

Durable Goods Orders

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.

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.

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.

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.

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.

FX Daily Time Series

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.

FX Intraday Time Series

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.

FX Monthly Time Series

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.

FX Weekly Time Series

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.

Get Dividend History

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

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.

Analytics Sliding Window

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.

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.

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.

Inflation

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

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.

Listing Status

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

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.

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.

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.

Real GDP

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

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.

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.

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.

Sector Performance

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

Stock 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.

Global Sugar Price

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

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.

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.

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.

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.

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.

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.

Monthly Adjusted Time Series

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.

Weekly Time Series

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.

Weekly Adjusted Time Series

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.

Top Gainers, Losers & Most Active

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.

US 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).

Unemployment Rate

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.

WHEAT

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

Frequently asked questions

What can I automate with Alpha Vantage on Definable?

Anything Alpha Vantage exposes through its API. Common analytics workflows on Definable include answer ad-hoc analytics questions, detect anomalies, auto-generate weekly summaries. Personas can call any of the 56 Alpha Vantage tools directly, then chain the result into another integration without you writing code.

How does Alpha Vantage authentication work?

Alpha Vantage uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Alpha Vantage integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 56 Alpha Vantage tools. You only need a separate Alpha Vantage subscription if Alpha Vantage itself charges per seat or per API call.

Is using Alpha Vantage through Definable secure?

Every call from a persona to Alpha Vantage is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Alpha Vantage on Definable?

Sign up for Definable, open the integrations page, find Alpha Vantage, and connect via OAuth or API key. You can immediately attach Alpha Vantage to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Alpha Vantage actions does Definable expose?

Definable exposes all 56 Alpha Vantage actions as callable tools — including `Get All Commodities Price Index`, `ALUMINUM`, `Balance Sheet`, plus 53 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Alpha Vantage?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations