Twelve Data

Twelve Data provides global stocks, forex, ETFs, fundamentals, and one of the deepest collections of technical indicators available on a single platform.

In Agent Forge, the Twelve Data integration lets workflows pull OHLC time series, real-time quotes, company fundamentals, and technical-indicator series (SMA, EMA, RSI, MACD, Bollinger Bands, Stochastic, ADX, ATR, VWAP, Ichimoku, and more) into agents. Use it for market analysis, signal generation, fundamentals-aware research agents, and indicator-driven alerts.

This is a bring-your-own-key (BYOK) integration. Each user supplies their own Twelve Data API key. The Free (Basic) tier prohibits commercial use; the Grow tier or higher is required for internal commercial workflows, and a Venture+ business plan is required for showing data to your own customers downstream (which also requires attribution: Data provided by Twelve Data (https://twelvedata.com)).

Usage Instructions

Choose an operation and provide a symbol (e.g. AAPL) or a forex pair (e.g. EUR/USD) along with your API key. Indicator and time-series operations also accept an interval (1min..1month), optional date range, and indicator-specific parameters (window, fast/slow/signal periods, standard deviations, etc.).

Tools

Reference

twelvedata_symbol_search - Search symbols by name across stocks, forex, and more
twelvedata_stocks_list - List available stocks, optionally filtered by exchange or country
twelvedata_forex_pairs_list - List available forex pairs
twelvedata_exchanges - List supported exchanges
twelvedata_market_state - Current open/closed status of markets

Market Data

twelvedata_time_series - OHLC time series for a symbol (the primary chart endpoint)
twelvedata_quote - Latest quote (OHLC, volume, change)
twelvedata_price - Real-time price
twelvedata_eod - Latest end-of-day price

Forex

twelvedata_exchange_rate - Current exchange rate for a currency pair
twelvedata_currency_conversion - Convert an amount between two currencies

Fundamentals

twelvedata_profile - Company profile (name, sector, industry, description)
twelvedata_statistics - Key statistics (market cap, P/E, beta, etc.)
twelvedata_dividends - Dividend history
twelvedata_splits - Stock split history
twelvedata_earnings - Earnings history
twelvedata_earnings_calendar - Upcoming earnings reports calendar

Indicators

twelvedata_sma - Simple Moving Average
twelvedata_ema - Exponential Moving Average
twelvedata_wma - Weighted Moving Average
twelvedata_rsi - Relative Strength Index
twelvedata_macd - Moving Average Convergence/Divergence
twelvedata_bbands - Bollinger Bands
twelvedata_stoch - Stochastic oscillator
twelvedata_adx - Average Directional Index
twelvedata_atr - Average True Range
twelvedata_vwap - Volume-Weighted Average Price
twelvedata_ichimoku - Ichimoku Cloud

Common Inputs

Parameter	Type	Required	Description
`apiKey`	string	Yes	Your Twelve Data API key
`symbol`	string	Operation-specific	Symbol or pair such as `AAPL` or `EUR/USD`
`interval`	string	Operation-specific	Time interval (`1min`, `5min`, `15min`, `30min`, `45min`, `1h`, `2h`, `4h`, `1day`, `1week`, `1month`)
`outputsize`	number	No	Number of data points to return
`start_date`	string	No	Start date
`end_date`	string	No	End date
`timezone`	string	No	Timezone such as `America/New_York`
`order`	string	No	Sort order (`ASC` or `DESC`)
`series_type`	string	No	Series type for indicators (`close`, `open`, `high`, `low`)
`time_period`	number	Operation-specific	Indicator lookback period
`fast_period`	number	Operation-specific	MACD fast period
`slow_period`	number	Operation-specific	MACD slow period
`signal_period`	number	Operation-specific	MACD signal period
`sd`	number	Operation-specific	Bollinger standard deviations
`amount`	number	Operation-specific	Amount for currency conversion

Output

Parameter	Type	Description
`data`	json	Twelve Data response data

Notes

Category: tools
Type: twelvedata
BYOK only. The platform does not hold a Twelve Data API key.
The Free (Basic) tier prohibits commercial use. Use the Grow tier or higher for internal commercial workflows.
Showing Twelve Data values to your own customers downstream requires a Venture+ business plan and attribution: Data provided by Twelve Data (https://twelvedata.com).
Redistribution of data requires a separate agreement with Twelve Data.

Twelve Data

On this page