# Twelve Data AI integration on Definable

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

## What this connects

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

Vendor: https://twelvedata.com/

## Tools available

**97** tools available. First 12:

- `TWELVE_DATA_CASH_FLOW` — Cash Flow — Tool to get company cash flow statement. Use when you need operating, investing, and financing cash flow details after selecting a company.
- `TWELVE_DATA_CASH_FLOW_CONSOLIDATED` — Consolidated Cash Flow — Tool to get raw consolidated cash flow statements. Use when you need detailed cash flow data for a company.
- `TWELVE_DATA_COMMODITIES_LIST` — List Commodities — Tool to retrieve a list of supported commodities. Use when you need all available commodities after obtaining a valid API key.
- `TWELVE_DATA_CORREL` — Correlation Coefficient — Tool to fetch Pearson correlation coefficient between two series over a period. Use after selecting identifiers and interval.
- `TWELVE_DATA_COUNTRIES_LIST` — 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.
- `TWELVE_DATA_CROSS_LISTINGS` — 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.
- `TWELVE_DATA_CRYPTOCURRENCIES` — 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.
- `TWELVE_DATA_CRYPTOCURRENCY_EXCHANGES_LIST_GET` — List Cryptocurrency Exchanges — Tool to list supported cryptocurrency exchanges. Use when you need a list of available crypto trading platforms.
- `TWELVE_DATA_CURRENCY_CONVERSION` — Currency Conversion — Tool to convert an amount from one currency to another. Use after confirming currency codes to retrieve real-time conversion.
- `TWELVE_DATA_DIVIDENDS` — Dividends — Tool to retrieve dividend payout history for a specified symbol. Use when you need historical dividends over multiple years.
- `TWELVE_DATA_EARNINGS` — Earnings — Tool to retrieve earnings data including EPS estimates and actuals. Use when you need detailed earnings history for a selected stock symbol.
- `TWELVE_DATA_EPS_REVISIONS` — 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.

## Auth

Auth schemes: `API_KEY`.

## How agents use Twelve Data

Inside a Definable workflow, Twelve Data is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Twelve Data** — the Researcher (GPT-5.5) pulls context from Twelve Data (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Twelve Data** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Twelve Data (create record, post message, draft email).
- **Designer / Engineer → Distributor → Twelve Data** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Twelve Data (attach file, open PR comment, post status).

The Verifier checks every Twelve Data call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- analytics — https://definable.ai/apps/category/analytics/
- business intelligence — https://definable.ai/apps/category/business-intelligence/

## Related

- HTML page: https://definable.ai/apps/twelve_data/
- Same category (analytics): https://definable.ai/apps/category/analytics/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt