# Twelve Data

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

- **Category:** analytics
- **Auth:** API_KEY
- **Tools:** 57
- **Triggers:** 0
- **Slug:** `TWELVE_DATA`
- **Version:** 20260211_00

## Tools

### Cash Flow

**Slug:** `TWELVE_DATA_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

**Slug:** `TWELVE_DATA_CASH_FLOW_CONSOLIDATED`

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

### List Commodities

**Slug:** `TWELVE_DATA_COMMODITIES_LIST`

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

### Correlation Coefficient

**Slug:** `TWELVE_DATA_CORREL`

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

### List Countries

**Slug:** `TWELVE_DATA_COUNTRIES_LIST`

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

**Slug:** `TWELVE_DATA_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

**Slug:** `TWELVE_DATA_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

**Slug:** `TWELVE_DATA_CRYPTOCURRENCY_EXCHANGES_LIST_GET`

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

### Currency Conversion

**Slug:** `TWELVE_DATA_CURRENCY_CONVERSION`

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

### Dividends

**Slug:** `TWELVE_DATA_DIVIDENDS`

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

### Earnings

**Slug:** `TWELVE_DATA_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

**Slug:** `TWELVE_DATA_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

**Slug:** `TWELVE_DATA_EPS_TREND_ACTION`

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

**Slug:** `TWELVE_DATA_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

**Slug:** `TWELVE_DATA_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

**Slug:** `TWELVE_DATA_ETFS_TYPE`

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

**Slug:** `TWELVE_DATA_ETFS_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

**Slug:** `TWELVE_DATA_ETFS_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

**Slug:** `TWELVE_DATA_ETFS_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

**Slug:** `TWELVE_DATA_EXCHANGES`

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

### List supported forex pairs

**Slug:** `TWELVE_DATA_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 Analyst Rating

**Slug:** `TWELVE_DATA_GET_ANALYST_RATING`

Tool to retrieve the analyst rating summary for a given symbol. Use when you need rating counts and a derived average score after selecting a symbol.

### Get API Usage

**Slug:** `TWELVE_DATA_GET_API_USAGE`

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

### Balance Sheet

**Slug:** `TWELVE_DATA_GET_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

**Slug:** `TWELVE_DATA_GET_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 Earliest Timestamp

**Slug:** `TWELVE_DATA_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.

### Global ETF Performance

**Slug:** `TWELVE_DATA_GET_ETFS_WORLD_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

**Slug:** `TWELVE_DATA_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.

### Income Statement

**Slug:** `TWELVE_DATA_GET_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

**Slug:** `TWELVE_DATA_GET_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.

### Key Executives

**Slug:** `TWELVE_DATA_GET_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

**Slug:** `TWELVE_DATA_GET_LAST_CHANGE`

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

### Get Logo

**Slug:** `TWELVE_DATA_GET_LOGO`

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

### Market Movers

**Slug:** `TWELVE_DATA_GET_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

**Slug:** `TWELVE_DATA_GET_MARKET_STATE`

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

### Global Mutual Fund Performance

**Slug:** `TWELVE_DATA_GET_MUTUAL_FUNDS_WORLD_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

**Slug:** `TWELVE_DATA_GET_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

**Slug:** `TWELVE_DATA_GET_MUTUAL_FUNDS_WORLD_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

**Slug:** `TWELVE_DATA_GET_MUTUAL_FUNDS_WORLD_SUSTAINABILITY`

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

### Price Target

**Slug:** `TWELVE_DATA_GET_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

**Slug:** `TWELVE_DATA_GET_PROFILE`

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

### Recommendations

**Slug:** `TWELVE_DATA_GET_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.

### Stock Splits

**Slug:** `TWELVE_DATA_GET_SPLITS`

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

### Splits Calendar

**Slug:** `TWELVE_DATA_GET_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

**Slug:** `TWELVE_DATA_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.

### List market indices

**Slug:** `TWELVE_DATA_INDICES`

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

### Institutional Holders

**Slug:** `TWELVE_DATA_INSTITUTIONAL_HOLDERS`

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

### Mutual Funds Family

**Slug:** `TWELVE_DATA_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

**Slug:** `TWELVE_DATA_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

**Slug:** `TWELVE_DATA_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

**Slug:** `TWELVE_DATA_OPTIONS_CHAIN_ACTION`

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

**Slug:** `TWELVE_DATA_OPTIONS_EXPIRATION`

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

### Quote

**Slug:** `TWELVE_DATA_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

**Slug:** `TWELVE_DATA_STOCKS_LIST`

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

**Slug:** `TWELVE_DATA_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

**Slug:** `TWELVE_DATA_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

**Slug:** `TWELVE_DATA_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.
