- UseBuildFeaturesTRIGGERSStart background agents from events across your connected appsFIREWALLNEWBlocks instructions hidden in tool results before your agent reads themINSTANTNEWAudio, video, search, browser and data tools, with no keys to manageOPTIMIZATIONLower cost per completed task with optimised tools and skills
- DOCS
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.SIGN UP
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.LOG IN
Twelve data API
Give your agents access to Twelve data API. Bring your own Twelve data key, or skip the signup and pay per call from your Composio balance with Composio Instant.
Twelve Data is a financial data API providing real-time and historical market data for stocks, forex, crypto, ETFs, and indices. It helps you access accurate, up-to-date financial information for analysis and automation.
What is Composio Instant?
Composio Instant lets your agent use paid APIs like Twelve data without a separate account or API key for each one. New accounts start with $2 of free credit.
Connect the Twelve data API to your AI assistant
Use Twelve data from the AI assistant you already work in. Connect Composio once, then paste the prompt.
- 1Install in ChatGPT
Install the Composio plugin
Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks. - 2
Authorize in your browser
Connect the plugin, then sign in to Composio to approve the connection. - 3
Turn on Composio in your chat
In a new chat, click +, then More, and select Composio. - 4
Paste the prompt
Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.
- 1Install in Cursor
Install the Composio plugin
Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser. - 2
Paste the prompt
Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.
- 1Add to Grok Bot
Add the Composio plugin
Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add. - 2
Authenticate
Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize. - 3
Paste the prompt
Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.
- 1
Paste the setup prompt
Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.Set up Composio from composio.dev/hermes - 2
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection. - 3
Paste the prompt
Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.
Paste this prompt
Use Twelve Data through Composio Instant to get the latest quote for AAPL. Return its OHLC values, volume, change, market-open status, and 52-week range.
What success looks like
TWELVE_DATA_GET_QUOTEYour assistant runs Twelve Data and replies with AAPL's latest quote, including OHLC values, volume, change, market-open status, and 52-week range.
Use the Twelve data API in your code
Call Twelve data from your own agent with the Composio SDK. Four steps and one tool call.
- 1
Set up Composio
Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.export COMPOSIO_API_KEY="your_composio_api_key" - 2
Install the SDK
The Python SDK needs Python 3.11 through 3.15.The TypeScript SDK is ESM-only and needs Node.js 22.22.3 or newer.pip install composionpm install @composio/core - 3TWELVE_DATA_GET_QUOTE
Run the call
Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account. - 4
Read the response
When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.
import { Composio } from "@composio/core";
const composio = new Composio();
const session = await composio.create("user_123", {
toolkits: ["twelve_data"],
instant: {
toolkits: { enable: ["twelve_data"] },
returnInstantCharge: true,
},
});
const result = await session.execute(
"TWELVE_DATA_GET_QUOTE",
{
"symbol": "AAPL"
},
{ account: "instant_account" },
);
console.log(result);
console.log("Instant charge:", result.instantCharge);{
"data": "<latest AAPL quote with OHLC values, volume, change, market-open status, and 52-week range>",
"error": null,
"successful": true,
"instant_charge": {
"amount": "<usd amount>",
"currency": "USD",
"charged_by": "<provider>"
}
}Available Twelve data API tools
71 Twelve data tools run on Instant, priced per call with no Twelve data key. Tools marked Your key need your own Twelve data account.
| Action | Tool slug | What it does | Availability |
|---|---|---|---|
| Get Quote | TWELVE_DATA_GET_QUOTE | Retrieve the latest quote, including price, volume, change, and market status. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Price History | TWELVE_DATA_GET_TIME_SERIES | Retrieve a bounded OHLCV history for a symbol and interval. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Find Symbols | TWELVE_DATA_SEARCH_SYMBOLS | Find tradable symbols and exchange IDs by ticker or name. | Instant$0.001 per 100 requests79% off |
| Get Batch Quotes | TWELVE_DATA_BATCH_GET_QUOTES | Fetch quotes for 1 to 8 symbols in one request. | Instant$0.001 per 100 requested symbols79% off |
| Convert Currency | TWELVE_DATA_CONVERT_CURRENCY | Convert an amount from the base to the quote currency using a current or historical forex or cryptocurrency rate. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Correlation Coefficient | TWELVE_DATA_CORREL | Tool to fetch Pearson correlation coefficient between two series over a period. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Cross Listings | TWELVE_DATA_CROSS_LISTINGS | Tool to retrieve cross-listed symbols for a security across multiple exchanges. | Instant$0.001 per 100 API credits79% off |
| Currency Conversion | TWELVE_DATA_CURRENCY_CONVERSION | Instant$0.001 per 100 requests79% off | |
| Dividends | TWELVE_DATA_DIVIDENDS | Retrieve dividend history for a specified symbol, optionally over a selected date range. | Instant$0.001 per 100 API credits79% off |
| Earnings | TWELVE_DATA_EARNINGS | Tool to retrieve earnings data including EPS estimates and actuals. | Instant$0.001 per 100 API credits79% off |
| ETFS Directory | TWELVE_DATA_ETFS_DIRECTORY | Tool to fetch a daily updated list of exchange-traded funds sorted by total assets. | Instant$0.001 per 100 requests79% off |
| ETFS Family | TWELVE_DATA_ETFS_FAMILY | Retrieve ETF family names grouped by country, optionally filtered by family name. | Instant$0.001 per 100 requests79% off |
| Get AD Indicator | TWELVE_DATA_GET_AD | Tool to retrieve Accumulation/Distribution (AD) indicator data for a financial instrument. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get APO (Absolute Price Oscillator) | TWELVE_DATA_GET_APO | Tool to calculate the Absolute Price Oscillator (APO) for a financial instrument. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Aroon Indicator | TWELVE_DATA_GET_AROON | Tool to retrieve Aroon Indicator data for identifying market trends. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Bollinger Bands | TWELVE_DATA_GET_BBANDS | Retrieve Bollinger Bands for a financial instrument, including upper, middle, and lower bands, to assess market volatility and potential price reversals. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get CCI | TWELVE_DATA_GET_CCI | Tool to retrieve Commodity Channel Index (CCI) values for a specified security. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Ceiling (CEIL) | TWELVE_DATA_GET_CEIL | Tool to retrieve the Ceiling (CEIL) transformation for a time series. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Chande Momentum Oscillator | TWELVE_DATA_GET_CMO | Tool to retrieve Chande Momentum Oscillator (CMO) data for a security. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Detrended Price Oscillator | TWELVE_DATA_GET_DPO | Tool to calculate the Detrended Price Oscillator (DPO) for a specified financial instrument. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Earliest Timestamp | TWELVE_DATA_GET_EARLIEST_TIMESTAMP | Tool to return the first available timestamp for a symbol and interval. | Instant$0.001 per 100 requests79% off |
| Get End of Day Price | TWELVE_DATA_GET_EOD | Retrieve an end-of-day closing price and metadata for a financial instrument, for a specified date or the most recent available date. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get ETF Types | TWELVE_DATA_ETFS_TYPE | Tool to retrieve ETF categories by market, including types like 'Equity Precious Metals'. | Instant$0.001 per 100 requests79% off |
| Get Exchange Rate | TWELVE_DATA_GET_EXCHANGE_RATE | Return the current or historical exchange rate for one forex or cryptocurrency pair. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Funds | TWELVE_DATA_GET_FUNDS | Tool to fetch a daily updated list of available investment funds. | Instant$0.001 per 100 requests79% off |
| Get Heikin Ashi Candles | TWELVE_DATA_GET_HEIKINASHI_CANDLES | Tool to retrieve Heikin Ashi candlestick data that smooths price action by averaging values. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Hilbert Transform Sine Wave | TWELVE_DATA_GET_HT_SINE | Fetch Hilbert Transform Sine Wave (HT_SINE) data for an instrument and interval, including sine and lead-sine components, for analyzing market cycles and potential turning points. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Ichimoku Cloud Indicator | TWELVE_DATA_GET_ICHIMOKU | Tool to retrieve Ichimoku Kinko Hyo indicator data for analyzing trend direction, support/resistance levels, and trading opportunities. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Keltner Channel | TWELVE_DATA_GET_KELTNER | Retrieve Keltner Channel indicator data for volatility-based technical analysis. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Last Change | TWELVE_DATA_GET_LAST_CHANGE | Tool to retrieve the latest update timestamps for a fundamentals dataset. | Instant$0.001 per 100 requests79% off |
| Get Latest Price | TWELVE_DATA_GET_LATEST_PRICE | Return only the latest available price for one market symbol; use Get Quote when OHLC, volume, change, or market status is needed. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Linear Regression Angle | TWELVE_DATA_GET_LINEARREGANGLE | Tool to calculate the linear regression angle for a given time series of stock prices. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Linear Regression Intercept | TWELVE_DATA_GET_LINEAR_REG_INTERCEPT | Retrieve linear regression intercept indicator values for a financial instrument over a specified period. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Linear Regression Slope | TWELVE_DATA_GET_LINEAR_REGSLOPE | Retrieve linear regression slope indicator values for a financial instrument over a specified period. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Logo | TWELVE_DATA_GET_LOGO | Tool to retrieve official logo URLs for a symbol. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get MACD | TWELVE_DATA_GET_MACD | Tool to calculate the Moving Average Convergence Divergence (MACD) for a specified financial instrument. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get MAMA | TWELVE_DATA_GET_MAMA | Tool to fetch MESA Adaptive Moving Average (MAMA) indicator data. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Market State | TWELVE_DATA_GET_MARKET_STATE | Tool to report current open/closed status for exchanges. | Instant$0.001 per 100 requests79% off |
| Get Maximum Value | TWELVE_DATA_GET_MAX | Retrieve the maximum-value technical indicator for a financial instrument's selected price or volume series over a given period. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get McGinley Dynamic Indicator | TWELVE_DATA_GET_MC_GINLEY_DYNAMIC | Tool to calculate the McGinley Dynamic indicator, which provides a refined moving average that adapts to market volatility. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Median Price | TWELVE_DATA_GET_MEDPRICE | Tool to calculate and retrieve the Median Price (MEDPRICE) technical indicator for a security. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Minus Directional Indicator | TWELVE_DATA_GET_MINUS_DI | Tool to calculate and return the Minus Directional Indicator (MINUS_DI) for a security. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Plus Directional Indicator | TWELVE_DATA_GET_PLUS_DI | Tool to fetch the Plus Directional Indicator (PLUS_DI) time series data for a security. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Price | TWELVE_DATA_GET_PRICE | Instant$0.001 per 100 requests, charged per symbol requested79% off | |
| Get Profile | TWELVE_DATA_GET_PROFILE | Tool to retrieve company profile. | Instant$0.001 per 100 API credits79% off |
| Get Rate of Change (ROC) | TWELVE_DATA_GET_ROC | Tool to retrieve Rate of Change (ROC) indicator data for a security. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Relative Volume | TWELVE_DATA_GET_RVOL | Tool to fetch relative volume (RVOL) data for a security. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get ROCP (Rate of Change Percentage) | TWELVE_DATA_GET_ROCP | Tool to calculate and return the Rate of Change Percentage (ROCP) for a financial security. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Simple Moving Average | TWELVE_DATA_GET_SIMPLE_MOVING_AVERAGE | Return a bounded simple moving average series for one symbol, interval, price field, and averaging period. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Stochastic RSI | TWELVE_DATA_GET_STOCHRSI | Tool to calculate the Stochastic Relative Strength Index (Stochastic RSI) for a specified financial instrument. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Summation (SUM) | TWELVE_DATA_GET_SUM | Tool to calculate the cumulative total (Summation) of a specified data series over a defined time period. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Technical Indicators List | TWELVE_DATA_GET_TECHNICAL_INDICATORS_LIST | Tool to retrieve a comprehensive list of available technical indicators. | Instant$0.001 per 100 requests79% off |
| Get TEMA (Triple Exponential Moving Average) | TWELVE_DATA_GET_TEMA | Tool to calculate the Triple Exponential Moving Average (TEMA) for a financial instrument. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Variance (VAR) | TWELVE_DATA_GET_VAR | Tool to calculate the statistical variance of a financial data series. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Weighted Close Price | TWELVE_DATA_GET_WCLPRICE | Tool to calculate and retrieve the Weighted Close Price (WCLPRICE) for a security. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| Get Weighted Moving Average (WMA) | TWELVE_DATA_GET_WMA | Tool to calculate and retrieve the Weighted Moving Average (WMA) for a security over a specified period. | Instant$0.001 per 100 requests, charged per symbol requested79% off |
| List Commodities | TWELVE_DATA_COMMODITIES_LIST | Retrieve the complete list of supported commodities. | Instant$0.001 per 100 requests79% off |
| List Countries | TWELVE_DATA_COUNTRIES_LIST | Retrieve country metadata including ISO codes, names, capitals, and currencies. | Instant$0.001 per 100 requests79% off |
| List Cryptocurrencies | TWELVE_DATA_CRYPTOCURRENCIES | List supported cryptocurrencies. | Instant$0.001 per 100 requests79% off |
| List Cryptocurrency Exchanges | TWELVE_DATA_CRYPTOCURRENCY_EXCHANGES_LIST_GET | Tool to list supported cryptocurrency exchanges. | Instant$0.001 per 100 requests79% off |
| List Stocks | TWELVE_DATA_LIST_STOCKS | List and filter stocks in Twelve Data's reference directory, one explicit page at a time. | Instant$0.001 per 100 requests79% off |
| List Stocks | TWELVE_DATA_STOCKS_LIST | Instant$0.001 per 100 requests79% off | |
| List supported exchanges | TWELVE_DATA_EXCHANGES | Tool to retrieve a list of supported exchanges. | Instant$0.001 per 100 requests79% off |
| List supported forex pairs | TWELVE_DATA_FOREX_PAIRS | Tool to retrieve a list of all supported forex currency pairs. | Instant$0.001 per 100 requests79% off |
| Mutual Funds Family | TWELVE_DATA_MUTUAL_FUNDS_FAMILY | List the mutual fund families available from investment companies. | Instant$0.001 per 100 requests79% off |
| Mutual Funds List | TWELVE_DATA_MUTUAL_FUNDS_LIST | Tool to retrieve a daily updated list of mutual funds sorted by total assets. | Instant$0.001 per 100 requests79% off |
| Quote | TWELVE_DATA_QUOTE | Instant$0.001 per 100 requests, charged per symbol requested79% off | |
| Splits Calendar | TWELVE_DATA_GET_SPLITS_CALENDAR | Tool to retrieve a calendar of stock split events. | Instant$0.001 per 100 API credits79% off |
| Stock Splits | TWELVE_DATA_GET_SPLITS | Tool to retrieve historical stock split events. | Instant$0.001 per 100 API credits79% off |
| Symbol Search | TWELVE_DATA_SYMBOL_SEARCH | Instant$0.001 per 100 requests79% off | |
| Time Series | TWELVE_DATA_TIME_SERIES | Instant$0.001 per 100 requests, charged per symbol requested79% off | |
| Get Income Statement | TWELVE_DATA_GET_INCOME_STATEMENT | Retrieve a company's annual or quarterly income statement. | Your key |
| Get Cash Flow | TWELVE_DATA_CASH_FLOW | Retrieve a company's cash flow statement. | Your key |
| Get Options Chain | TWELVE_DATA_OPTIONS_CHAIN_ACTION | Retrieve the options chain for a symbol and expiration date. | Your key |
Instant prices are Twelve data's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.
Twelve data API use cases and example prompts
Copy a prompt into your agent. Each one uses Twelve data with apps you connect through Composio.
Share a market snapshot
Use Twelve Data to get quotes for the symbols in my Watchlist sheet in Google Sheets, up to eight at a time. Update each row with the latest price, volume, change, and market status, then post a summary in Slack's #market-research channel.
Apps used: Twelve data, Google Sheets, Slack
Write a price history brief
Use Twelve Data to retrieve daily OHLCV history for the ticker on my Market Watch page in Notion. Write a brief on the price and volume trend in my Market Review doc in Google Docs.
Apps used: Twelve data, Notion, Google Docs
Add symbols to account records
Use Twelve Data to find tradable symbols and exchange IDs for the company names in my target account records in HubSpot. Add the results to my Account Coverage sheet in Google Sheets, and flag entries with multiple possible matches for review.
Apps used: Twelve data, HubSpot, Google Sheets
Track target price changes
Use Twelve Data to get quotes for the symbols in my Price Watch sheet in Google Sheets, up to eight at a time. Update the latest price and change, then draft a Gmail summary for any symbol whose quote has crossed its target price.
Apps used: Twelve data, Google Sheets, Gmail
Twelve data API troubleshooting
Still stuck? The Instant tools docs cover limits, charges and session settings.
Search the ticker with TWELVE_DATA_SEARCH_SYMBOLS, then set exchange or mic_code in TWELVE_DATA_GET_QUOTE to disambiguate it.
Set start_date and end_date in TWELVE_DATA_GET_TIME_SERIES to define the window, and raise output_size up to 5000. Each response is bounded and has no continuation token.
Check its availability in the tools table. If it runs on Instant, check that Instant Toolkits is on for your project, your session allows the action and you use the latest toolkit version.
Your Composio balance is empty. Add funds in Billing if your plan supports it, or connect your own Twelve data account.
Check credential_source and instant_charge in the Composio execution log.
Other tools on Instant
These tools also run on Composio Instant and use the same Composio balance.
Alpha vantage
Alpha Vantage is a financial data platform offering real-time and historical stock market APIs. Get instant, reliable access to equities, forex, and technical analysis data for smarter trading decisions.
Finnhub
Finnhub is a market data API delivering real-time quotes, company fundamentals, and financial news. Use it to power trading apps, research, alerts, and analytics with timely market intelligence.
Firecrawl
Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.
Tavily
Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.
Start with Twelve data.It takes 30 seconds.
Managed auth, hosted MCP servers, and every Twelve data tool your agent needs.Free to start.
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.Start building

