Twelve Data is a technology-driven platform offering financial market data, powerful tools, and tailored solutions — all through a single, unified API. Our mission is to make financial data accessible to everyone, from individual developers to Fortune 500 enterprises.
This introductory guide will walk you through the basics of Twelve Data, including:
Data coverage: Discover the wide variety of datasets we provide.
REST API: Learn how to access financial data through our unified API.
WebSocket API: Understand how to stream real-time quotes.
Credits: See how your API and WebSocket usage is calculated.
Spreadsheets and SDKs: Explore add-ons for Excel, Python, and more.
Next steps: Dive deeper into Twelve Data.
Data coverage
Twelve Data covers nearly one million instruments across multiple asset classes in real-time, delayed, and historical formats. Our data is available at intraday intervals (ranging from 1 minute to 8 hours) and daily intervals (from 1 day to 1 month). Beyond price data, we also provide:
Fundamentals: Corporate actions, financials, logos, and more.
Analysis: Revenue estimates, price targets, analyst expectations, etc.
ETFs & Mutual Funds: Detailed holdings, profiles, and risk assessments.
Asset classes
Stocks: U.S. markets and over 60 global regions. Including 20+ sub-categories, such as REITs and warrants.
Forex: Real-time and historical data for 140 world currencies.
Cryptocurrencies: Real-time quotes from top centralized and decentralized exchanges.
ETFs: Funds from 50+ countries, covering a diverse range of markets.
Mutual Funds: Over 200,000 actively managed funds worldwide.
Note: Access to specific data types and markets may vary based on your subscription tier. Refer to our Pricing page and Documentation for details. If you need assistance with data coverage or usage rights, contact support@twelvedata.com.
REST API
Our unified API grants you access to all data covered by Twelve Data.
You can:
Try out the endpoints with live example requests.
Use batch requests for efficient data retrieval.
Choose from multiple output formats.
Access profound historical records.
and much more can be explored in the Documentation.
Sign up for the Basic plan to test any endpoint with our trial symbols (listed on the Exchanges page). When you’re ready to grow, upgrade your plan for expanded coverage and advanced features.
WebSocket API
If you need real-time streaming quotes, our WebSocket service has you covered. You can also test this feature using the same trial system as the API. Please note:
WebSocket access is available starting from the Pro plan.
Refer to the WebSocket Documentation for instructions on setting up and handling subscriptions.
Credits
Twelve Data uses a credit system to track your platform usage. Credits come in two types:
API credits
Credits are consumed with each request.
The number of credits used depends on the endpoint, determined by factors such as:
Data complexity
Endpoint popularity
Resource usage
Credits automatically regenerate every minute.
WebSocket credits
Credits are consumed each time you send a subscription event.
Each subscribed instrument costs 1 credit, which is instantly recovered upon unsubscribing.
WebSocket access is available from the Pro plan onward.
Tip: Check the documentation to see the credit weight per endpoint and choose a plan that matches your needs.
Spreadsheets & SDKs
Take advantage of our free packages and add-ons to seamlessly integrate Twelve Data into your workflow:
Excel: Real-time price updates with our dedicated plugin.
Google Sheets: Automated updates and easy access to all instruments.
SDKs and libraries: Industry-leading support for Python, R, and other open-source packages.
Read next