Twelve Data

Streams real time and historical market data into your workflows to automate portfolio monitoring, trade signals, and financial reporting.

Try Twelve Data in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Twelve Data integration

    • Describe the outcome and Ceven picks the right Twelve Data calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Twelve Data data, across all 97 of its actions.
  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Twelve Data access.
    • Per user and per environment credentials instead of shared keys.
  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Twelve Data, when, and on whose behalf.
    • The agent pauses and asks when Twelve Data is unclear instead of plowing ahead.
  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Twelve Data.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Twelve Data action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Twelve Data, and when to use it.

Get Quote
Pull the latest real time price and market data for a specific symbol.
Time Series
Retrieve historical or real time price bars for a symbol over a set time range.
Symbol Search
Find the correct ticker symbol using a company name or partial symbol string.
Technical Indicators
Fetch time series data for a specific indicator like RSI or MACD for a symbol.
Options Chain
Pull the full options chain including strike prices and Greeks for a given symbol.
Earnings
Retrieve historical earnings data including actual EPS versus analyst estimates.
Currency Conversion
Convert a specific amount from one currency to another using real time rates.
Dividends
Pull the dividend payout history for a stock to analyze yield trends.
EPS Trend
Get historical EPS trends to see how analyst estimates shifted before a report.
List Stocks
Fetch a list of available stocks filtered by exchange or country.
List Cryptocurrencies
Pull a complete list of all supported cryptocurrency symbols.
Options Expiration
Find all available expiration dates for a specific options symbol.
ETFS Directory
Get a list of ETFs sorted by total assets or filtered by exchange.
List Market Indices
Retrieve a list of global market indices filtered by country.
EPS Revisions
Pull analyst revisions of future earnings over the last week or month.
List Commodities
Tool to retrieve a list of supported commodities. use when you need all available commodities after obtaining a valid api key.
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.
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.
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.
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.

23 actions · scroll to see them all

Frequently asked questions

Ceven implements a smart queuing system that respects the specific credit limits of your Twelve Data plan. Because Twelve Data enforces strict per minute and per day request caps based on your tier, the agent tracks the remaining quota in real time. If a workflow triggers a large batch of requests that would exceed your limit, Ceven automatically staggers the calls and pauses execution until the window resets. This prevents your API key from being temporarily blocked. You can configure the agent to prioritize certain critical symbols over general market scans to ensure your most important data arrives first during periods of high volatility.
Yes. Ceven leverages the unified nature of the Twelve Data API to mix asset classes within a single automation. You can build a workflow that monitors the price of Bitcoin and Ethereum alongside the S and P 500 and specific tech stocks. The agent can pull the crypto quotes and stock quotes simultaneously, then use the currency conversion tool to normalize all values into your preferred base currency. This is particularly useful for traders who want to see the correlation between traditional equity markets and the crypto market in a single consolidated report delivered to their dashboard every morning.
The latency depends on the exchange and your Twelve Data subscription tier. For most major US exchanges, the data is delivered in near real time. Ceven optimizes this by maintaining a persistent connection to the API and only requesting the specific fields you need for your workflow. If you are using the agent for high frequency monitoring, we recommend using the quote endpoint rather than the time series endpoint to reduce payload size and speed up the response time. The agent can then push these updates to your notification channel the millisecond the API returns the new price.
Ceven uses the Symbol Search tool as a pre flight step for any workflow where the ticker is not explicitly known. If you tell the agent to monitor a company by its name, it first queries Twelve Data to find the exact ticker and exchange. Once the symbol is verified, the agent caches it for the duration of the workflow to avoid redundant API calls. This ensures that if a company changes its ticker or if you are dealing with assets across different global exchanges, the agent always pulls data for the correct instrument without failing due to an invalid symbol error.
Ceven utilizes the built in technical indicator engine provided by Twelve Data. Instead of pulling raw price data and calculating the moving average or RSI locally, the agent requests the specific indicator and parameters directly from the API. This ensures that the calculations match the industry standard provided by Twelve Data. You can specify the interval, such as one minute or one day, and the indicator name. The agent then takes that processed data and can use it to trigger further actions, such as sending an alert when the RSI drops below thirty.
Historical data availability varies by asset class and exchange. While major stocks and forex pairs have extensive history, some smaller cryptocurrencies or niche ETFs may have shorter time series. Ceven handles this by attempting to pull the requested range and then providing a graceful fallback if the API returns a limited data set. The agent will notify you of the actual date range retrieved so your analysis is based on the available data. For very long time horizons, the agent uses the time series endpoint with pagination to ensure no data points are missed during the retrieval process.
Ceven can access the options chain and expiration dates via Twelve Data to provide deep visibility into derivative markets. The agent can pull strike prices and the Greeks for a specific symbol, allowing you to automate the search for undervalued contracts or monitor the open interest of a specific strike. Note that options data is often gated behind higher Twelve Data subscription tiers. If your account does not have the required permissions, the agent will receive an unauthorized error and will inform you exactly which plan upgrade is needed to unlock options data for your workflows.
For portfolios with assets in multiple currencies, Ceven uses the Currency Conversion tool as a middleware step. When the agent pulls a price for a stock listed in EUR and another in JPY, it identifies the currency of each asset and calls the conversion endpoint to translate them into your account currency. This happens in the background before the data is aggregated into a total value. The agent also timestamps the conversion rate used, ensuring that your financial reports are transparent and that you can audit the exchange rates applied at the exact moment the portfolio was valued.

Alternatives to Twelve Data

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Twelve Data and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free