All Collections
Getting Started
Introduction to Twelve Data
Introduction to Twelve Data

Getting started on Twelve Data with easy steps

Team avatar
Written by Team
Updated over a week ago

Twelve Data is a technology-driven platform that provides financial market data financial tools and dedicated solutions through a unified interface. Being the leading data-providing platform, we make financial data accessible to everyone, from individual developers to large businesses.

This introduction article will help you to become familiar with Twelve Data.

  • Data covered. Explore what different types of data we provide.

  • Twelve Data API. Single interface to access all the data.

  • WebSocket. Streaming of real-time quotes.

  • Credits. Understand how API and WebSocket consumption is calculated.

  • Spreadsheets and add-ons. See various Excel, Python, and other extensions.

  • Read next. Dig deeper into Twelve Data.

Data covered

Twelve Data offers data for over 100,000+ instruments in real-time. All assets data is available at intraday (1-minute to 8-hours) and at daily (1-day to 1-month) intervals. In addition to this, we provide additional fundamentals data, including logos, financials, options, and much more.

Markets are divided into Basic, Level A, and Level B accesses. With the free plan, you get access to US markets, forex, and crypto. With Grow tier - to Level A, and with Pro tier or above - to level B.

Below are the main components:

  • Stock. US exchanges and over 60+ international exchanges.

  • Forex. Real-time foreign exchange rates and historical data for 140 world currencies.

  • Cryptocurrency. Most popular crypto exchanges in the world with real-time updates.

  • ETF. Covers different forms of funds sourced from 50+ countries.

  • Index. World's most popular indices, as well as rare ones.

Twelve Data API

Through a single API interface, you can access all data covered by Twelve Data. Check out the comprehensive documentation to get started with the API format and execute real-time examples. API supports many cool features such as batch requests, JSON/CSV formats, precisely retrieving historical data, and many others.

Before purchasing a paid plan, you can test all the endpoints with various international symbols. To get onboard sign up with the Basic plan and follow the trial article.


Via WebSocket, you can stream real-time prices and daily volume. You can also test it with the same trial system as the API. Complete access is granted started with the Pro plan. For more details visit the WebSocket documentation section.


Twelve Data uses a credit system to track your usage of our platform which makes sure that you get the most of it. Credits could be of two types: API credits and WebSocket credits.

API credits are used when you make a request to any of the endpoints. All endpoints have a varying weight that uses fewer credits for the most-used datasets and more credits for more specific ones. You can consult each individual weighting at the corresponding section of an endpoint in the documentation. Some endpoints are available starting from Grow, Pro, or Enterprise plans. API credits are restored each minute.

WebSocket credits are used when subscribing to the server. Each instrument passed inside the subscription event has a weight of 1 credit. Once you unsubscribe from the instrument's updates its credit is recovered instantly. WebSocket is available starting with the Pro plan.

Spreadsheets and add-ons

We provide some packages and spreadsheet add-ins that you can use in addition to accessing Twelve Data directly - all of them are available at no cost.

  • Excel. Receive real-time prices updates with one of our plugins.

  • Google Sheets. Automatic updates and access to all instruments with a few clicks.

  • SDKs and libraries. Industry-leading Python and R packages. More are coming.

Read next

Did this answer your question?