Twelve Data for AI agents
Agents read Twelve Data at once. Changes and sends are held for a person's approval by default.
About Twelve Data
Twelve Data provides a comprehensive financial data API offering real-time and historical market data for stocks, forex, cryptocurrencies, ETFs, and indices.
What an agent can do in Twelve Data
Every Twelve Data action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Twelve Data without asking first. 100 actions.
- List CommoditiesRetrieve the complete list of supported commodities.
- List CryptocurrenciesList supported cryptocurrencies. Call with no arguments for the complete catalogue, or provide symbol/outputsize to return a bounded filtered list.
- DividendsTool to retrieve dividend payout history for a specified symbol. Use when you need historical dividends over multiple years.
- EarningsTool to retrieve earnings data including EPS estimates and actuals. Use when you need detailed earnings history for a selected stock symbol.
- ETFS DirectoryTool to fetch a daily updated list of exchange-traded funds sorted by total assets. Use when you need a directory of ETFs by exchange or country.
- List supported exchangesTool to retrieve a list of supported exchanges. Use when you need all available stock and forex exchanges.
- List supported forex pairsTool to retrieve a list of all supported forex currency pairs. Use when exploring available forex pairs before making other forex data requests.
- Get APO (Absolute Price Oscillator)Tool to calculate the Absolute Price Oscillator (APO) for a financial instrument. The APO measures the difference between two moving averages to identify price trends and momentum changes. Use when yo
- Get Bollinger BandsTool to calculate Bollinger Bands (BBANDS) for a financial instrument. Returns upper band, lower band, and simple moving average (SMA) to assess market volatility and identify potential price reversal
- Get BondsTool to retrieve a daily updated list of available bonds (fixed income securities). Use when you need to fetch bonds with optional filtering by symbol, exchange, or country.
- Get FundsTool to fetch a daily updated list of available investment funds. Use when you need a directory of funds with optional filtering by symbol, country, exchange, or other identifiers.
- Get TEMA (Triple Exponential Moving Average)Tool to calculate the Triple Exponential Moving Average (TEMA) for a financial instrument. TEMA applies three layers of exponential smoothing to price data, providing a smoother trend line with reduce
Show all 100
- List market indicesTool to retrieve a list of market indices. Use when you need to fetch available indices filtered by country.
- Mutual Funds ListTool to retrieve a daily updated list of mutual funds sorted by total assets. Use when you need to enumerate available mutual funds for analysis.
- Options ChainTool to retrieve the options chain for a given symbol and optional expiration date. Use when you need detailed option contract data and Greeks. Omitting date returns all expirations.
- Options ExpirationTool to retrieve available option expiration dates. Use when exploring available expiration dates for a given options symbol.
- Technical IndicatorsTool to fetch time-series data for a specific technical indicator. Use when you have a symbol, interval, and indicator name.
- Batch Get QuotesFetch quotes for 1-8 symbols in one batch, returning success or error for every symbol; partial child failures do not fail successful quotes. Each symbol consumes one API credit.
- Cash FlowTool to get company cash flow statement. Use when you need operating, investing, and financing cash flow details after selecting a company.
- Consolidated Cash FlowTool to get raw consolidated cash flow statements. Use when you need detailed cash flow data for a company.
- Convert CurrencyConvert an amount from the base to the quote currency using a current or historical forex or cryptocurrency rate. Costs one API credit.
- Correlation CoefficientTool to fetch Pearson correlation coefficient between two series over a period. Use after selecting identifiers and interval.
- List CountriesRetrieve country metadata including ISO codes, names, capitals, and currencies.
- Cross ListingsTool to retrieve cross-listed symbols for a security across multiple exchanges. Use when you need to list all market listings of a given instrument.
- List Cryptocurrency ExchangesTool to list supported cryptocurrency exchanges. Use when you need a list of available crypto trading platforms.
- EPS RevisionsTool to provide analysts’ revisions of a company’s future EPS over the last week and month. Use after confirming the stock symbol.
- EPS TrendTool to retrieve EPS trend estimates for a specified company. Use after selecting a stock symbol to view how EPS estimates have changed over time. Returns EPS estimates for next quarter, current year,
- ETFS FamilyTool to fetch a comprehensive list of ETFs by family. Use when you need to list ETFs managed by a specific investment company.
- Get ETF TypesTool to retrieve ETF categories by market, including types like 'Equity Precious Metals'. No parameters are needed. Returns a dictionary mapping country names to lists of ETF types available in that c
- ETF WorldTool to fetch comprehensive ETF analytics (summary, performance, risk, composition). Use when you need a detailed overview of an ETF's metrics and holdings.
- ETF World CompositionTool to fetch global ETF composition details including sector, country, asset allocations, top holdings, and bond metrics. Use after selecting an ETF to analyze its composition.
- ETF World RiskTool to get global ETF risk metrics. Use when you need to analyze volatility and valuation ratios for an ETF.
- Get AD IndicatorTool to retrieve Accumulation/Distribution (AD) indicator data for a financial instrument. The AD line uses closing price, price range, and trading volume to identify buying or selling pressure and as
- Get Aroon IndicatorTool to retrieve Aroon Indicator data for identifying market trends. Returns Aroon Up and Aroon Down values showing time elapsed since highest high and lowest low. Use when analyzing trend direction a
- Balance SheetTool to retrieve a company's balance sheet (assets, liabilities, equity). Use when you need annual or quarterly financial position data for a given symbol or identifier.
- Balance Sheet ConsolidatedTool to get raw consolidated balance sheet data (assets, liabilities, equity) for a company. Use when you need detailed historical balance sheet by period.
- Get CCITool to retrieve Commodity Channel Index (CCI) values for a specified security. Use when you need to detect potential price reversals by identifying overbought or oversold conditions through momentum
- Get Ceiling (CEIL)Tool to retrieve the Ceiling (CEIL) transformation for a time series. Rounds each value in the input data series up to the nearest whole number. Use when you need ceiling-adjusted price data for a sym
- Get Chande Momentum OscillatorTool to retrieve Chande Momentum Oscillator (CMO) data for a security. Use when you need to analyze momentum and identify overbought or oversold conditions. Requires at least one instrument identifier
- Get Detrended Price OscillatorTool to calculate the Detrended Price Oscillator (DPO) for a specified financial instrument. Use when you need to identify short-term price cycles and potential overbought or oversold conditions witho
- Get Earliest TimestampTool to return the first available timestamp for a symbol and interval. Use after selecting instrument identifiers and interval to discover the earliest data point.
- Get End of Day PriceTool to retrieve end of day (EOD) closing price and metadata for a financial instrument. Use when you need daily historical data for stocks, ETFs, or other securities to track performance over time.
- Global ETF PerformanceTool to get global ETF performance metrics (trailing and annual returns). Use when you need detailed performance analytics for an ETF.
- Get Exchange RateReturn the current or historical exchange rate for one forex or cryptocurrency pair. Costs one API credit.
- Get exchange scheduleTool to get trading sessions and hours for exchanges. Use when you need pre-market, main, and post-market hours for a given exchange and date.
- Get Fund HoldersTool to retrieve mutual fund holders for a company. Use when you need details about mutual fund ownership including shares held and percentage of outstanding shares.
- Get Heikin Ashi CandlesTool to retrieve Heikin Ashi candlestick data that smooths price action by averaging values. Use when you need to identify trends with reduced market noise for technical analysis.
- Get HLC3 AverageTool to calculate the High, Low, Close Average (HLC3) for a security over a specified period. Use when you need to assess average price trends quickly.
- Get Hilbert Transform Sine WaveTool to fetch Hilbert Transform Sine Wave (HT_SINE) data for an instrument. The HT_SINE provides sine and cosine wave components derived from the dominant market cycle, helping traders pinpoint potent
- Get Ichimoku Cloud IndicatorTool to retrieve Ichimoku Kinko Hyo indicator data for analyzing trend direction, support/resistance levels, and trading opportunities. Use when you need to evaluate market trends and identify strateg
- Income StatementTool to retrieve a company's income statement data (annual or quarterly). Use when you need detailed income metrics for a given symbol or identifier.
- Insider TransactionsREQUIRES PRO, ULTRA, OR ENTERPRISE PLAN. Retrieve insider trading transactions for a company including officer/trader names, transaction types (Buy/Sell), dates, share counts, and amounts. Use when yo
- Get Available IntervalsTool to retrieve a list of available time intervals supported by the API. Use when you need to know which interval values are valid for time series queries.
- Get Keltner ChannelTool to retrieve Keltner Channel indicator data for volatility-based technical analysis. Use when you need to identify potential overbought/oversold conditions, assess trend direction, or analyze pric
- Key ExecutivesREQUIRES ULTRA OR ENTERPRISE PLAN. Retrieve company leadership data including executive names, titles, ages, and compensation. Use when you need detailed management info by symbol or other identifier.
- Get Last ChangeTool to retrieve the latest update timestamps for a fundamentals dataset. Use when checking recent changes (e.g., dividends, splits).
- Get Latest PriceReturn only the latest available price for one market symbol; use Get Quote when OHLC, volume, change, or market status is needed. Costs one API credit.
- Get Linear Regression AngleTool to calculate the linear regression angle for a given time series of stock prices. Returns the slope of the trend line expressed in degrees, which helps identify the direction and steepness of a t
- Get Linear Regression InterceptTool to calculate the y-intercept of a linear regression line for a given dataset. Returns the value where the regression line crosses the y-axis over a specified period.
- Get Linear Regression SlopeTool to calculate the linear regression slope for a given dataset over a specified period. Returns the slope of a linear regression line, reflecting the rate of change in the data trend. Use when you
- Get Base-10 Logarithm (LOG10)Tool to compute the base-10 logarithm (LOG10) of a specified input value. Returns the power to which 10 must be raised to obtain the input value. Use when you need to transform data into a logarithmic
- Get LogoTool to retrieve official logo URLs for a symbol. Use when displaying company, crypto, or forex pair logos in UIs.
- Get MACDTool to calculate the Moving Average Convergence Divergence (MACD) for a specified financial instrument. Returns the MACD line, signal line, and histogram values to identify potential trend reversals
- Get MAMATool to fetch MESA Adaptive Moving Average (MAMA) indicator data. Use when you need to calculate an adaptive moving average that adjusts to market cycles for trend identification and reversal analysis
- Market MoversTool to retrieve a snapshot of top gainers or losers for a specified market. Use when you need to quickly see market movers after choosing a market type.
- Get Market StateTool to report current open/closed status for exchanges. Use when you need real-time market status updates after selecting exchanges.
- Get Maximum ValueTool to calculate and return the highest value within a specified data series over a given period. Use when identifying potential resistance levels or detecting extreme price movements in financial da
- Get McGinley Dynamic IndicatorTool to calculate the McGinley Dynamic indicator, which provides a refined moving average that adapts to market volatility. Use when tracking price movements with reduced lag and identifying support o
- Get Median PriceTool to calculate and retrieve the Median Price (MEDPRICE) technical indicator for a security. MEDPRICE represents the average of high and low prices over a specified period, providing a simplified vi
- Get Minus Directional IndicatorTool to calculate and return the Minus Directional Indicator (MINUS_DI) for a security. Use when analyzing bearish trends and assessing downward price movement strength.
- Global Mutual Fund PerformanceTool to get global mutual fund performance metrics (trailing, annual, quarterly, load-adjusted returns). Use when you need detailed performance analytics for a mutual fund.
- Mutual Funds World RiskTool to fetch global mutual fund risk metrics. Use when you need detailed risk analytics (standard deviation, beta, Sharpe ratio) for a specific mutual fund identifier.
- Global Mutual Fund SummaryTool to retrieve a global mutual fund summary snapshot. Use when you need a high-level overview of a fund’s key identifiers and attributes.
- Global Mutual Fund SustainabilityTool to get global mutual fund sustainability and ESG metrics. Use when you need fund ESG scores and pillar breakdowns.
- Get Plus Directional IndicatorTool to fetch the Plus Directional Indicator (PLUS_DI) time series data for a security. Use when you need to assess the strength and intensity of upward price movements over a specified period.
- Price TargetTool to fetch analysts' price target dataset for equities. Use when you need the latest and historical price forecasts for a symbol.
- Get ProfileTool to retrieve company profile. Use when you need company details like industry, sector, and identifiers after selecting a symbol.
- Get QuoteReturn the latest quote for one symbol, including OHLC, volume when available, change, market-open status, and 52-week range. Costs one API credit.
- RecommendationsRetrieve aggregated analyst recommendations for a stock. Returns buy/sell/hold consensus ratings across multiple time periods (current month, previous month, 2 and 3 months ago). Use this to understan
- Get Rate of Change (ROC)Tool to retrieve Rate of Change (ROC) indicator data for a security. ROC calculates the percentage change in price over a defined period, returning a time series of values that help track momentum. Us
- Get ROCP (Rate of Change Percentage)Tool to calculate and return the Rate of Change Percentage (ROCP) for a financial security. Use when you need to identify shifts in price momentum and potential trend reversals.
- Get ROCR100Tool to calculate the Rate of Change Ratio 100 (ROCR100) for a security. The ROCR100 calculates the percentage change in a security's price over a specified period, expressed as a ratio to 100. Use wh
- Get Relative VolumeTool to fetch relative volume (RVOL) data for a security. RVOL provides a ratio comparing a security's current trading volume to its average volume over a specified period, helping detect unusual trad
- Get Simple Moving AverageReturn a bounded simple moving average series for one symbol, interval, price field, and averaging period. Costs one API credit.
- Stock SplitsTool to retrieve historical stock split events. Use when you need to fetch split history for a particular instrument.
- Splits CalendarTool to retrieve a calendar of stock split events. Use when you need to fetch split events for instruments over a date range.
- Get StatisticsTool to retrieve key company statistics including valuation and financial overview. Use when you need a company financial snapshot after selecting an instrument.
- Get Stochastic RSITool to calculate the Stochastic Relative Strength Index (Stochastic RSI) for a specified financial instrument. Returns %K and %D line values to identify overbought or oversold conditions and potentia
- Get Summation (SUM)Tool to calculate the cumulative total (Summation) of a specified data series over a defined time period. Returns numerical values representing the sum of financial data such as stock prices or tradin
- Get Technical Indicators ListTool to retrieve a comprehensive list of available technical indicators. Use when you need to discover which technical analysis tools are available.
- Get Time SeriesReturn a bounded OHLCV history window for one symbol and interval; this does not paginate or fetch an unbounded history. Costs one API credit.
- Get Usage LimitsReturn the connected key's current minute and daily usage, limits, plan category, and timestamp. The check itself consumes one API credit.
- Get Variance (VAR)Tool to calculate the statistical variance of a financial data series. Use when you need to measure the volatility or dispersion of security prices over a specified period to assess risk.
- Get Weighted Close PriceTool to calculate and retrieve the Weighted Close Price (WCLPRICE) for a security. WCLPRICE gives additional weight to the closing price using the formula (High + Low + Close * 2) / 4. Use when you ne
- Get Weighted Moving Average (WMA)Tool to calculate and retrieve the Weighted Moving Average (WMA) for a security over a specified period. Use when you need to analyze short-term price trends with recent prices having higher influence
- Institutional HoldersTool to retrieve institutional holders positions for a company. Use when you need summary ownership metrics and top institutions.
- List StocksList and filter stocks in Twelve Data's reference directory, one explicit page at a time. Increment page while has_more is true. Each page costs one API credit; this tool never fetches additional page
- Mutual Funds FamilyList the mutual fund families available from investment companies.
- Mutual Funds World CompositionTool to fetch global mutual fund portfolio composition including sectors, asset allocation, top holdings, and bond metrics. Use after selecting a mutual fund to analyze its composition.
- Search SymbolsFind tradable instrument symbols and exchange identifiers by ticker or name; returns a bounded match list with no pagination.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 0 actions.
None in this connector.
Twelve Data questions
Can an agent change data in Twelve Data on its own?
Not by default. Changes and sends in Twelve Data are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Twelve Data?
This connector lists 100 read actions. Reads run at once, without waiting for approval.
How does Twelve Data connect?
It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.