Twelve Data

97 tools available

Twelve Data provides a comprehensive financial data API offering real-time and historical market data for stocks, forex, cryptocurrencies, ETFs, and indices.

Connect Twelve Data to Definable to answer ad-hoc analytics questions, detect anomalies, auto-generate weekly summaries. Personas call Twelve Data's 97 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 Twelve Data

01

Weekly anomaly digest

  1. Query metrics from this tool
  2. Compare against rolling baseline
  3. Surface anomalies with reasoning
02

Funnel deep-dive

  1. Pull funnel events for a date range
  2. Compute drop-offs at each step
  3. Generate a written analysis
03

Cohort answers on demand

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

Twelve Data actions 97

Every Twelve Data action below is a callable tool any Definable persona can invoke.

Cash Flow

Tool to get company cash flow statement. Use when you need operating, investing, and financing cash flow details after selecting a company.

Consolidated Cash Flow

Tool to get raw consolidated cash flow statements. Use when you need detailed cash flow data for a company.

List Commodities

Tool to retrieve a list of supported commodities. Use when you need all available commodities after obtaining a valid API key.

Correlation Coefficient

Tool to fetch Pearson correlation coefficient between two series over a period. Use after selecting identifiers and interval.

List Countries

Tool to retrieve a list of countries with ISO codes, names, capitals, and currencies. Use when you need country metadata after obtaining a valid API key.

Cross Listings

Tool 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 Cryptocurrencies

Tool to list all supported cryptocurrencies. Use when you need the complete set of crypto symbols. Use after obtaining a valid API key.

List Cryptocurrency Exchanges

Tool to list supported cryptocurrency exchanges. Use when you need a list of available crypto trading platforms.

Currency Conversion

Tool to convert an amount from one currency to another. Use after confirming currency codes to retrieve real-time conversion.

Dividends

Tool to retrieve dividend payout history for a specified symbol. Use when you need historical dividends over multiple years.

Earnings

Tool to retrieve earnings data including EPS estimates and actuals. Use when you need detailed earnings history for a selected stock symbol.

EPS Revisions

Tool to provide analysts’ revisions of a company’s future EPS over the last week and month. Use after confirming the stock symbol.

EPS Trend

Tool 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, and next year, showing how estimates have evolved from 7, 30, 60, and 90 days ago.

ETFS Directory

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

ETFS Family

Tool to fetch a comprehensive list of ETFs by family. Use when you need to list ETFs managed by a specific investment company.

Get ETF Types

Tool to retrieve ETF categories by market, including types like 'Equity Precious Metals'. Use after confirming API key is set; no parameters are needed. Returns a dictionary mapping country names to lists of ETF types available in that country.

ETF World

Tool 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 Composition

Tool 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 Risk

Tool to get global ETF risk metrics. Use when you need to analyze volatility and valuation ratios for an ETF.

List supported exchanges

Tool to retrieve a list of supported exchanges. Use when you need all available stock and forex exchanges.

List supported forex pairs

Tool to retrieve a list of all supported forex currency pairs. Use when exploring available forex pairs before making other forex data requests.

Get AD Indicator

Tool 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 assess price movement strength.

Get API Usage

Tool to retrieve your current plan and remaining API credits. Use when monitoring your subscription usage in real-time.

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 you need to analyze momentum and potential price reversals.

Get Aroon Indicator

Tool 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 and momentum for a specific symbol.

Balance Sheet

Tool 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 Consolidated

Tool to get raw consolidated balance sheet data (assets, liabilities, equity) for a company. Use when you need detailed historical balance sheet by period.

Get Bollinger Bands

Tool 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 reversals.

Get Bonds

Tool 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 CCI

Tool 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 analysis.

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

Get Chande Momentum Oscillator

Tool 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 (symbol, isin, figi, or cusip) and an interval.

Get Detrended Price Oscillator

Tool 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 without long-term trend influence.

Get Earliest Timestamp

Tool 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 Price

Tool 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 Performance

Tool to get global ETF performance metrics (trailing and annual returns). Use when you need detailed performance analytics for an ETF.

Get exchange schedule

Tool 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 Holders

Tool 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 Funds

Tool 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 Heikin Ashi Candles

Tool 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 Average

Tool 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 Wave

Tool 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 potential market turning points and assess trend directions by analyzing cyclical patterns. Use when analyzing market cycles for a specific symbol and interval.

Get Ichimoku Cloud Indicator

Tool 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 strategic entry/exit points.

Income Statement

Tool 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 Transactions

REQUIRES 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 you need detailed insider trading activity data. This endpoint is only available to Pro/Ultra/Enterprise subscribers - requests with lower-tier API keys will fail with a 403 error.

Get Available Intervals

Tool 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 Channel

Tool 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 price volatility using the combination of Exponential Moving Average (EMA) and Average True Range (ATR).

Key Executives

REQUIRES 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. This endpoint costs 1000 credits per request and is only available to Ultra/Enterprise subscribers - requests with lower-tier API keys will fail.

Get Last Change

Tool to retrieve the latest update timestamps for a fundamentals dataset. Use when checking recent changes (e.g., dividends, splits).

Get Linear Regression Angle

Tool 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 trend over a specified period. Use when you need to detect upward or downward trends in asset prices.

Get Linear Regression Intercept

Tool 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 Slope

Tool 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 need to assess the direction and strength of a trend in financial time series data.

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 scale for analyzing exponential growth patterns or compressing large ranges of financial data.

Get Logo

Tool to retrieve official logo URLs for a symbol. Use when displaying company, crypto, or forex pair logos in UIs.

Get MACD

Tool 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 and trading opportunities.

Get MAMA

Tool 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 Movers

Tool 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 State

Tool to report current open/closed status for exchanges. Use when you need real-time market status updates after selecting exchanges.

Get Maximum Value

Tool 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 data.

Get McGinley Dynamic Indicator

Tool 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 or resistance levels.

Get Median Price

Tool 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 view of price trends. Use when you need to assess price movements by focusing on the midpoint of price action.

Get Minus Directional Indicator

Tool 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 Performance

Tool 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 Risk

Tool 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 Summary

Tool 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 Sustainability

Tool to get global mutual fund sustainability and ESG metrics. Use when you need fund ESG scores and pillar breakdowns.

Get Plus Directional Indicator

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

Get Price

Tool to retrieve the latest market price for a specified financial instrument. Use when you need to get the current price after identifying a symbol.

Price Target

Tool to fetch analysts' price target dataset for equities. Use when you need the latest and historical price forecasts for a symbol.

Get Profile

Tool to retrieve company profile. Use when you need company details like industry, sector, and identifiers after selecting a symbol.

Recommendations

Retrieve 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 understand Wall Street sentiment and analyst opinions about a company.

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. Use after selecting a symbol and interval to identify potential price movements.

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 ROCR100

Tool 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 when you need to assess the momentum and direction of a security's price trend over time.

Get Relative Volume

Tool 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 trading activity and assess the strength of price movements.

Stock Splits

Tool to retrieve historical stock split events. Use when you need to fetch split history for a particular instrument.

Splits Calendar

Tool to retrieve a calendar of stock split events. Use when you need to fetch split events for instruments over a date range.

Get Statistics

Tool to retrieve key company statistics including valuation and financial overview. Use when you need a company financial snapshot after selecting an instrument.

Get Stochastic RSI

Tool 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 potential price reversals. Use when you need to refine entry and exit points by analyzing momentum indicators.

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 trading volumes. Use when you need to track the aggregate value of a dataset for further analysis.

Get Technical Indicators List

Tool to retrieve a comprehensive list of available technical indicators. Use when you need to discover which technical analysis tools are available.

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 reduced lag compared to simple moving averages. Use when you need to identify trends with minimal delay for trading signals.

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 Price

Tool 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 need to analyze price trends with emphasis on closing values.

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.

List market indices

Tool to retrieve a list of market indices. Use when you need to fetch available indices filtered by country.

Institutional Holders

Tool to retrieve institutional holders positions for a company. Use when you need summary ownership metrics and top institutions.

Mutual Funds Family

Tool to list all available mutual fund families. Use when you need a comprehensive list of mutual fund families managed by investment companies after obtaining a valid API key.

Mutual Funds List

Tool to retrieve a daily updated list of mutual funds sorted by total assets. Use when you need to enumerate available mutual funds for analysis.

Mutual Funds World Composition

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

Options Chain

Tool 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 Expiration

Tool to retrieve available option expiration dates. Use when exploring available expiration dates for a given options symbol.

Quote

Tool to retrieve the latest market data for a specified symbol. Use when you need a quick real-time quote after selecting a symbol.

List Stocks

Tool to retrieve a list of stocks. Use when you need to fetch securities with optional filtering by exchange, country, type, or symbol.

Symbol Search

Tool to search for financial instruments by symbol or company name. Use when you need to discover available symbols before making further data requests.

Technical Indicators

Tool to fetch time-series data for a specific technical indicator. Use when you have a symbol, interval, and indicator name.

Time Series

Tool to retrieve historical and real-time time series data for a specified symbol. Use when you need to fetch price data over a time range after selecting a symbol. Response data points are not guaranteed to be in chronological or reverse-chronological order; always sort by timestamp before indexing.

Frequently asked questions

What can I automate with Twelve Data on Definable?

Anything Twelve Data 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 97 Twelve Data tools directly, then chain the result into another integration without you writing code.

How does Twelve Data authentication work?

Twelve Data 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 Twelve Data integration included in my Definable plan?

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

Is using Twelve Data through Definable secure?

Every call from a persona to Twelve Data 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 Twelve Data on Definable?

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

What Twelve Data actions does Definable expose?

Definable exposes all 97 Twelve Data actions as callable tools — including `Cash Flow`, `Consolidated Cash Flow`, `List Commodities`, plus 94 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Twelve Data?

Wire it up in minutes. No coding required.

← All integrations