n8n-nodes-twelve-data

This is an n8n community node for the Twelve Data API. It provides access to comprehensive financial market data including stocks, forex, cryptocurrencies, ETFs, and more.

n8n is a fair-code licensed workflow automation platform.

Table of Contents

• Installation
• Credentials
• Compatibility
• Usage
• Example Workflows
• Known Limitations
• Resources
• Version History

Installation

Follow the installation guide in the n8n community nodes documentation.

For n8n Cloud

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-twelve-data in the Enter npm package name field
4. Select Install

For Self-Hosted n8n

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-twelve-data in the Enter npm package name field
4. Select Install

Alternatively, install via npm in your n8n installation directory:

npm install n8n-nodes-twelve-data

Then restart n8n.

Credentials

To use this node, you need a Twelve Data API key.

Setup

1. Sign up at twelvedata.com
2. Get your free API key from the dashboard
3. In n8n, go to Settings → Credentials → Create → "Twelve Data API"
4. Paste your API key and save

Authentication

The node supports two authentication methods:

• Header Authentication (Recommended) - API key sent in request header
• Query Parameter - API key added to URL

Choose the method that works best for your setup. Header authentication is more secure for production use.

Demo Key

For quick testing, you can use the demo API key: demo

Note: The demo key has limited functionality. Get your own free API key for full access.

Compatibility

• Minimum n8n version: 1.0.0
• Tested up to: Latest version

Usage

Available Operations

The Twelve Data node provides access to 161 API endpoints organized into 6 main resource categories:

Core Data (Market Data)

• Get Quote - Real-time price quotes with bid, ask, open, high, low, close, volume
• Get Price - Lightweight current price lookup
• Get Time Series - Historical OHLCV data with customizable intervals (1min to 1month)
• Get End of Day Price - Daily closing prices for specific dates
• Get Exchange Rate - Real-time currency conversion rates
• Currency Conversion - Convert amounts between currencies
• Get Market Movers (All Markets) - Top gainers, losers, and most active stocks
• Get Time Series Cross - Cross-currency pair time series data

Reference Data

• List Stocks - Browse and filter available stock symbols
• List Forex Pairs - Available currency pairs
• List Cryptocurrencies - Supported crypto assets
• List ETFs - Exchange-traded funds
• List ETFs (Extended) - Extended ETF information
• List ETF Families - ETF family classifications
• List ETF Types - ETF type categories
• List Indices - Market indices (S&P 500, NASDAQ, etc.)
• List Exchanges - Trading venues and their details
• List Countries - Available countries for market data
• List Intervals - Supported time intervals
• List Mutual Fund Families - Mutual fund family classifications
• List Mutual Fund Types - Mutual fund type categories
• List Technical Indicators - Available technical indicators
• List Fundamentals - Available fundamental data types
• List Market Data - Available market data types
• List Analysis - Available analysis types
• Symbol Search - Search for symbols by name or ticker
• Get Market State - Check if markets are open or closed

Technical Indicators (91 operations)

• Moving Averages (9): SMA, EMA, DEMA, TEMA, WMA, TRIMA, KAMA, MAMA, T3
• Momentum Indicators (16): RSI, MACD, ADX, CCI, MOM, ROC, STOCH, TRIX, etc.
• Volatility Indicators (5): ATR, BBANDS, NATR, SUPERTREND, TRANGE
• Volume Indicators (4): AD, ADOSC, OBV, VWAP
• Trend Indicators (10): AROON, SAR, ICHIMOKU, HT_TRENDMODE, etc.
• Statistical Functions (9): BETA, CORREL, LINEARREG, STDDEV, VAR, etc.
• Overlap Studies (14): AVGPRICE, MEDPRICE, MIDPOINT, TYPPRICE, etc.
• Math Transform (25): ACOS, ADD, ASIN, ATAN, COS, EXP, LN, LOG10, MAX, MIN, etc.

Fundamentals (20 operations)

• Get Balance Sheet - Company balance sheet data
• Get Balance Sheet Consolidated - Consolidated balance sheet data
• Get Cash Flow - Cash flow statement data
• Get Cash Flow Consolidated - Consolidated cash flow data
• Get Dividends - Historical dividend payment records
• Get Dividends Calendar - Upcoming dividend announcements
• Get Earnings - Historical and upcoming earnings data
• Get Earnings Calendar - Upcoming earnings announcements
• Get Fund Holders - Mutual fund ownership data
• Get Income Statement - Income statement data
• Get Income Statement Consolidated - Consolidated income statement
• Get Insider Transactions - Insider buying and selling activity
• Get Institutional Holders - Institutional ownership data
• Get IPO Calendar - Upcoming IPO listings
• Get Key Executives - Company executive information
• Get Market Cap - Market capitalization data
• Get Profile - Company information (sector, industry, employees, description)
• Get Splits Calendar - Upcoming stock split announcements
• Get Statistics - Key financial statistics and metrics
• Get Stock Splits - Historical stock split data

Market Intelligence (10 operations)

• Get Analyst Ratings - Consensus recommendations
• Get Analyst Ratings (Light) - Lightweight analyst ratings
• Get Price Target - Analyst price predictions
• Get Recommendations - Recommendation trends
• Get Earnings Estimate - Forward-looking earnings estimates
• Get Revenue Estimate - Revenue estimates
• Get EPS Trend - Earnings per share trend data
• Get EPS Revisions - EPS estimate revisions
• Get Growth Estimates - Growth estimates
• Get EDGAR Filings - SEC filing information
• Get Economic Calendar - Upcoming economic events

Advanced (3 operations)

• API Usage - Get API usage statistics and remaining credits
• Batch Request - Get multiple data types for multiple symbols in one request
• Get Logo - Get company logo URL

Example Workflows

1. Get Stock Quote

Trigger → Twelve Data (Quote) → Process Data

Get real-time price for AAPL, MSFT, or any stock.

2. Monitor Crypto Prices

Schedule → Twelve Data (Quote) → If Price > X → Send Alert

Set up price alerts for Bitcoin, Ethereum, etc.

3. Technical Analysis

Twelve Data (Time Series) → Twelve Data (RSI) → Make Decision

Calculate RSI indicator and trigger trades.

4. Currency Conversion

Twelve Data (Exchange Rate) → Calculate → Store Result

Convert between any currency pairs.

Tips

• Start with the demo key for testing
• Monitor rate limits in your Twelve Data dashboard
• Use batch requests when possible to reduce API calls

Example Workflows

Ready-to-import workflow examples are available in the examples/ directory:

See examples/README.md for import instructions and customization tips.

Known Limitations

Free Tier Restrictions

The Twelve Data free tier has some limitations:

API Tier Requirements

Understanding API Tiers:

Twelve Data offers different subscription tiers. The connector works with all tiers - it's the API access that varies.

Free Tier (Fully Supported):

• Core data operations (quotes, time series, exchange rates)
• Reference data (lists of stocks, forex, crypto, ETFs, indices)
• Company profiles
• Market intelligence data
• 800 API calls per day, 8 per minute

Paid Tier Required (grow/pro/ultra/enterprise):

• Advanced fundamentals: Get Dividends, Get Earnings, Get Statistics
• Calendars: Earnings Calendar, IPO Calendar
• Real-time data (free tier has 15-minute delay)
• Higher rate limits
• Extended historical data

Options Data

Options Chain and Options Expiration data are currently only available in the Twelve Data Google Sheets Add-on and not exposed via the REST API. These operations will be added to this node once Twelve Data makes them available in the REST API.

Interval Limitations

• 1-minute interval may return 5-minute data on free tier
• Hourly and daily intervals work correctly on free tier

Performance Notes

• Average response time: < 1 second
• Large datasets (1000+ items) may show n8n UI warning but load successfully
• Recommended: Add 0.5-1 second delay between requests in loops to avoid rate limiting

Resources

• Twelve Data Website - Sign up and get API key
• Twelve Data API Docs - Official API documentation
• Twelve Data Pricing - Plan comparison
• n8n Community Forum - Get help from the community
• n8n Documentation - Learn more about n8n

Support

• Issues: GitHub Issues
• Twelve Data Support: support@twelvedata.com
• n8n Community: community.n8n.io

Version History

0.2.5 (Current)

• Documentation updates: synced version references, operation counts, and version history across all docs

0.2.4

• Fixed peerDependency n8n-workflow version range changed to * per n8n verification requirement

0.2.3

• Removed 3 non-functional operations flagged by n8n verification team:
  • Get Complex Data (Core Data) — REST API endpoint not yet available
  • Get Options Chain (Fundamentals) — only available in Google Sheets Add-on
  • Get Options Expiration (Fundamentals) — only available in Google Sheets Add-on
• Sorted all operation lists alphabetically per n8n UX guidelines
• Added GitHub Actions publish workflow with npm provenance (required from May 2026)
• Total operations: 161

0.2.0

• Added 22 new operations across multiple categories
• Fundamentals: Balance Sheet Consolidated, Cash Flow Consolidated, Dividends Calendar, Income Statement Consolidated, Market Cap, Splits Calendar
• Core Data: Market Movers (All Markets), Time Series Cross
• Reference Data: List Countries, ETFs (Extended), ETF Families, ETF Types, Intervals, Mutual Fund Families, Mutual Fund Types, Technical Indicators, Fundamentals, Market Data, Analysis
• Market Intelligence: Analyst Ratings (Light), EDGAR Filings, EPS Revisions
• Total operations: 164 (up from 142)

0.1.0

• Initial release with 142+ operations across 6 resource categories
• Support for stocks, forex, cryptocurrencies, ETFs, and indices
• 91 technical indicators for market analysis
• Comprehensive fundamentals and market intelligence data
• Header and query parameter authentication
• Zero runtime dependencies

License

MIT

Disclaimer

This is a community-maintained node and is not officially affiliated with Twelve Data or n8n. Use at your own risk.

Made with ❤️ for the n8n community