Welcome to Twelve Data developer docs — your gateway to comprehensive financial market data through a powerful and easy-to-use API. Twelve Data provides access to financial markets across over 50 global countries, covering more than 1 million public instruments, including stocks, forex, ETFs, mutual funds, commodities, and cryptocurrencies.
To get started, you'll need to sign up for an API key. Once you have your API key, you can start making requests to the API.
Sign up on the Twelve Data website to create your account here. This gives you access to the API dashboard and your API key.
After signing in, navigate to your dashboard to find your unique API key. This key is required to authenticate all API and WebSocket requests.
Try a simple API call with cURL to fetch the latest price for Apple (AAPL):
curl "https://api.twelvedata.com/price?symbol=AAPL&apikey=your_api_key"
Use our client libraries or standard HTTP clients to make API calls programmatically. Here’s an example in Python and JavaScript:
from twelvedata import TDClient
# Initialize client with your API key
td = TDClient(apikey="your_api_key")
# Get latest price for Apple
price = td.price(symbol="AAPL").as_json()
print(price)
const fetch = require('node-fetch');
fetch('https://api.twelvedata.com/price?symbol=AAPL&apikey=your_api_key')
.then(response => response.json())
.then(data => console.log(data));
Fetch historical price data for Tesla (TSLA) and Microsoft (MSFT) and calculate the correlation of their closing prices:
from twelvedata import TDClient
import pandas as pd
# Initialize client with your API key
td = TDClient(apikey="your_api_key")
# Fetch historical price data for Tesla
tsla_ts = td.time_series(
symbol="TSLA",
interval="1day",
outputsize=100
).as_pandas()
# Fetch historical price data for Microsoft
msft_ts = td.time_series(
symbol="MSFT",
interval="1day",
outputsize=100
).as_pandas()
# Align data on datetime index
combined = pd.concat(
[tsla_ts['close'].astype(float), msft_ts['close'].astype(float)],
axis=1,
keys=["TSLA", "MSFT"]
).dropna()
# Calculate correlation
correlation = combined["TSLA"].corr(combined["MSFT"])
print(f"Correlation of closing prices between TSLA and MSFT: {correlation:.2f}")
Authenticate your requests using one of these methods:
GET https://api.twelvedata.com/endpoint?symbol=AAPL&apikey=your_api_key
Authorization: apikey your_api_key
apikey=demo) available for demo requests| Service | Base URL |
|---|---|
| REST API | https://api.twelvedata.com |
| WebSocket | wss://ws.twelvedata.com |
& to separate multiple parameterssymbol=AAPL = symbol=aaplAll responses return JSON format by default unless otherwise specified.
Important: Some response fields may contain null values when data is unavailable for specific metrics. This is expected behavior, not an error.
null value handling in your applicationStructure your code to gracefully handle:
429 Too Many Requests).Twelve Data API employs a standardized error response format, delivering a JSON object with code, message, and status keys for clear and consistent error communication.
Below is a table of possible error codes, their HTTP status, meanings, and resolution steps:
| Code | status | Meaning | Resolution |
|---|---|---|---|
| 400 | Bad Request | Invalid or incorrect parameter(s) provided. | Check the message in the response for details. Refer to the API Documentation to correct the input. |
| 401 | Unauthorized | Invalid or incorrect API key. | Verify your API key is correct. Sign up for a key here. |
| 403 | Forbidden | API key lacks permissions for the requested resource (upgrade required). | Upgrade your plan here. |
| 404 | Not Found | Requested data could not be found. | Adjust parameters to be less strict as they may be too restrictive. |
| 414 | Parameter Too Long | Input parameter array exceeds the allowed length. | Follow the message guidance to adjust the parameter length. |
| 429 | Too Many Requests | API request limit reached for your key. | Wait briefly or upgrade your plan here. |
| 500 | Internal Server Error | Server-side issue occurred; retry later. | Contact support here for assistance. |
Consider the following invalid request:
https://api.twelvedata.com/time_series?symbol=AAPL&interval=0.99min&apikey=your_api_key
Due to the incorrect interval value, the API returns:
{
"code": 400,
"message": "Invalid **interval** provided: 0.99min. Supported intervals: 1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 8h, 1day, 1week, 1month",
"status": "error"
}
Refer to the API Documentation for valid parameter values to resolve such errors.
Twelve Data provides a growing ecosystem of libraries and integrations to help you build faster and smarter in your preferred environment. Official libraries are actively maintained by the Twelve Data team, while selected community-built libraries offer additional flexibility.
A full list is available on our GitHub profile.
The community has developed libraries in several popular languages. You can explore more community libraries on GitHub.
Access real-time and historical market prices—time series and exchange rates—for equities, forex, cryptocurrencies, ETFs, and more. These endpoints form the foundation for any trading or data-driven application.
The time series endpoint provides detailed historical data for a specified financial instrument. It returns two main components: metadata, which includes essential information about the instrument, and a time series dataset. The time series consists of chronological entries with Open, High, Low, and Close prices, and for applicable instruments, it also includes trading volume. This endpoint is ideal for retrieving comprehensive historical price data for analysis or visualization purposes.
API credits cost
1 per symbol
symbol
stringSymbol ticker of the instrument. E.g. AAPL, EUR/USD, ETH/BTC, ...
Example:
AAPL
figi
stringThe FIGI of an instrument for which data is requested
Example:
BBG01293F5X4
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
✱ interval
stringInterval between two consecutive points in time series
Supports: 1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 5h, 1day, 1week, 1month
Example:
1min
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringThe country where the instrument is traded, e.g., United States or US
Example:
United States
type
stringThe asset class to which the instrument belongs
Supports: American Depositary Receipt, Bond, Bond Fund, Closed-end Fund, Common Stock, Depositary Receipt, Digital Currency, ETF, Exchange-Traded Note, Global Depositary Receipt, Limited Partnership, Mutual Fund, Physical Currency, Preferred Stock, REIT, Right, Structured Product, Trust, Unit, Warrant
Example:
Common Stock
outputsize
integerNumber of data points to retrieve. Supports values in the range from 1 to 5000. Default 30 when no date parameters are set, otherwise set to maximum
Default:
30
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringThe separator used in the CSV response data
Default:
;
prepost
booleanReturns quotes that include pre-market and post-market data. Only for Pro and above plans.
Available at the 1min, 5min, 15min, and 30min intervals for US equities.
Open, high, low, close values are supplied without volume
Default:
false
dp
integerSpecifies the number of decimal places for floating values. Should be in range [0, 11] inclusive. By default, the number of decimal places is automatically determined based on the values provided
Default:
-1
order
stringSorting order of the output
Supports: asc, desc
Default:
desc
timezone
stringTimezone at which output datetime will be displayed. Supports:
Exchange for local exchange timeUTC for datetime at universal UTC standardAmerica/New_York, Asia/Singapore. Full list of timezones can be found here
Default:
Exchange
date
stringSpecifies the exact date to get the data for. Could be the exact date, e.g. 2021-10-27, or in human language today or yesterday
Example:
2021-10-27
start_date
stringCan be used separately and together with end_date. Format 2006-01-02 or 2006-01-02T15:04:05
Default location:
UTCAmerica/New_York)timezone parameter is provided.timezone is given then, start_date and end_date will be used in the specified location
Examples:
&symbol=AAPL&start_date=2019-08-09T15:50:00&…&symbol=EUR/USD&timezone=Asia/Singapore&start_date=2019-08-09T15:50:00&…&symbol=ETH/BTC&timezone=Europe/Zurich&start_date=2019-08-09T15:50:00&end_date=2019-08-09T15:55:00&...
Example:
2024-08-22T15:04:05
end_date
stringThe ending date and time for data selection, see start_date description for details.
Example:
2024-08-22T16:04:05
previous_close
booleanA boolean parameter to include the previous closing price in the time_series data. If true, adds previous bar close price value to the current object
Default:
false
adjust
stringAdjusting mode for prices
Supports: all, splits, dividends, none
Default:
splits
Request example
Response
{
"meta": {
"symbol": "AAPL",
"interval": "1min",
"currency": "USD",
"exchange_timezone": "America/New_York",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"type": "Common Stock"
},
"values": [
{
"datetime": "2021-09-16 15:59:00",
"open": "148.73500",
"high": "148.86000",
"low": "148.73000",
"close": "148.85001",
"volume": "624277"
}
],
"status": "ok"
}The Time Series Cross endpoint calculates and returns historical cross-rate data for exotic forex pairs, cryptocurrencies, or stocks (e.g., Apple Inc. price in Indian Rupees) on the fly. It provides metadata about the requested symbol and a time series array with Open, High, Low, and Close prices, sorted descending by time, enabling analysis of price history and market trends.
API credits cost
5 per symbol
✱ base
stringBase currency symbol
Example:
JPY
base_type
stringBase instrument type according to the /instrument_type endpoint
Example:
Physical Currency
base_exchange
stringBase exchange
Example:
Binance
base_mic_code
stringBase MIC code
Example:
XNGS
✱ quote
stringQuote currency symbol
Example:
BTC
quote_type
stringQuote instrument type according to the /instrument_type endpoint
Example:
Digital Currency
quote_exchange
stringQuote exchange
Example:
Coinbase
quote_mic_code
stringQuote MIC code
Example:
XNYS
✱ interval
stringInterval between two consecutive points in time series
Supports: 1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 1day, 1week, 1month
Example:
1min
outputsize
integerNumber of data points to retrieve. Supports values in the range from 1 to 5000. Default 30 when no date parameters are set, otherwise set to maximum
Example:
30
format
stringFormat of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringDelimiter used in CSV file
Default:
;
prepost
booleanOnly for Pro and above plans.
Available at the 1min, 5min, 15min, and 30min intervals for US equities.
Open, high, low, close values are supplied without volume.
Default:
false
start_date
stringStart date for the time series data
Example:
2025-01-01
end_date
stringEnd date for the time series data
Example:
2025-01-31
adjust
booleanSpecifies if there should be an adjustment
Default:
true
dp
integerSpecifies the number of decimal places for floating values. Should be in range [0, 11] inclusive.
Default:
5
timezone
stringTimezone at which output datetime will be displayed. Supports:
Exchange for local exchange timeUTC for datetime at universal UTC standardAmerica/New_York, Asia/Singapore. Full list of timezones can be found here.
Example:
UTC
Response
{
"meta": {
"base_instrument": "JPY/USD",
"base_currency": "",
"base_exchange": "PHYSICAL CURRENCY",
"interval": "1min",
"quote_instrument": "BTC/USD",
"quote_currency": "",
"quote_exchange": "Coinbase Pro"
},
"values": [
{
"datetime": "2025-02-28 14:30:00",
"open": "0.0000081115665",
"high": "0.0000081273069",
"low": "0.0000081088287",
"close": "0.0000081268066"
}
]
}The quote endpoint provides real-time data for a selected financial instrument, returning essential information such as the latest price, open, high, low, close, volume, and price change. This endpoint is ideal for users needing up-to-date market data to track price movements and trading activity for specific stocks, ETFs, or other securities.
API credits cost
1 per symbol
symbol
stringSymbol ticker of the instrument
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG000BHTMY7
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
interval
stringInterval of the quote
Supports: 1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 1day, 1week, 1month
Default:
1day
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
volume_time_period
integerNumber of periods for Average Volume
Default:
9
type
stringThe asset class to which the instrument belongs
Supports: American Depositary Receipt, Bond, Bond Fund, Closed-end Fund, Common Stock, Depositary Receipt, Digital Currency, ETF, Exchange-Traded Note, Global Depositary Receipt, Limited Partnership, Mutual Fund, Physical Currency, Preferred Stock, REIT, Right, Structured Product, Trust, Unit, Warrant
Example:
ETF
format
stringValue can be JSON or CSV Default JSON
Supports: JSON, CSV
Default:
JSON
delimiter
stringSpecify the delimiter used when downloading the CSV file
Default:
;
prepost
booleanParameter is optional. Only for Pro and above plans.
Available at the 1min, 5min, 15min, and 30min intervals for US equities.
Open, high, low, close values are supplied without volume.
Default:
false
eod
booleanIf true, then return data for closed day
Supports: true, false
Default:
false
rolling_period
integerNumber of hours for calculate rolling change at period. By default set to 24, it can be in range [1, 168].
Default:
24
dp
integerSpecifies the number of decimal places for floating values Should be in range [0,11] inclusive
Default:
5
timezone
stringTimezone at which output datetime will be displayed. Supports:
Exchange for local exchange timeUTC for datetime at universal UTC standardAmerica/New_York, Asia/Singapore. Full list of timezones can be found here.
Default:
Exchange
Request example
Response
{
"symbol": "AAPL",
"name": "Apple Inc",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"currency": "USD",
"datetime": "2021-09-16",
"timestamp": 1631772000,
"last_quote_at": 1631772000,
"open": "148.44000",
"high": "148.96840",
"low": "147.22099",
"close": "148.85001",
"volume": "67903927",
"previous_close": "149.09000",
"change": "-0.23999",
"percent_change": "-0.16097",
"average_volume": "83571571",
"rolling_1d_change": "123.123",
"rolling_7d_change": "123.123",
"rolling_change": "123.123",
"is_market_open": false,
"fifty_two_week": {
"low": "103.10000",
"high": "157.25999",
"low_change": "45.75001",
"high_change": "-8.40999",
"low_change_percent": "44.37440",
"high_change_percent": "-5.34782",
"range": "103.099998 - 157.259995"
},
"extended_change": "0.09",
"extended_percent_change": "0.05",
"extended_price": "125.22",
"extended_timestamp": "1649845281"
}The latest price endpoint provides the latest market price for a specified financial instrument. It returns a single data point representing the current (or the most recently available) trading price.
API credits cost
1 per symbol
symbol
stringSymbol ticker of the instrument
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG000BHTMY7
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
type
stringThe asset class to which the instrument belongs
Supports: American Depositary Receipt, Bond, Bond Fund, Closed-end Fund, Common Stock, Depositary Receipt, Digital Currency, ETF, Exchange-Traded Note, Global Depositary Receipt, Limited Partnership, Mutual Fund, Physical Currency, Preferred Stock, REIT, Right, Structured Product, Trust, Unit, Warrant
Example:
ETF
format
stringValue can be JSON or CSV
Supports: JSON, CSV
Default:
JSON
delimiter
stringSpecify the delimiter used when downloading the CSV file
Default:
;
prepost
booleanParameter is optional. Only for Pro and above plans.
Available at the 1min, 5min, 15min, and 30min intervals for US equities.
Open, high, low, close values are supplied without volume.
Default:
false
dp
integerSpecifies the number of decimal places for floating values. Should be in range [0,11] inclusive
Default:
5
Request example
Response
{
"price": "200.99001"
}The End of Day (EOD) Prices endpoint provides the closing price and other relevant metadata for a financial instrument at the end of a trading day. This endpoint is useful for retrieving daily historical data for stocks, ETFs, or other securities, allowing users to track performance over time and compare daily market movements.
API credits cost
1 per symbol
symbol
stringSymbol ticker of the instrument
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG000BHTMY7
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
type
stringThe asset class to which the instrument belongs
Supports: American Depositary Receipt, Bond, Bond Fund, Closed-end Fund, Common Stock, Depositary Receipt, Digital Currency, ETF, Exchange-Traded Note, Global Depositary Receipt, Limited Partnership, Mutual Fund, Physical Currency, Preferred Stock, REIT, Right, Structured Product, Trust, Unit, Warrant
Example:
ETF
date
stringIf not null, then return data from a specific date
Example:
2006-01-02
prepost
booleanParameter is optional. Only for Pro and above plans.
Available at the 1min, 5min, 15min, and 30min intervals for US equities.
Open, high, low, close values are supplied without volume
Default:
false
dp
integerSpecifies the number of decimal places for floating values Should be in range [0,11] inclusive
Default:
5
Request example
Response
{
"symbol": "AAPL",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"currency": "USD",
"datetime": "2021-09-16",
"close": "148.79"
}The market movers endpoint provides a ranked list of the top-gaining and losing assets for the current trading day. It returns detailed data on the highest percentage price increases and decreases since the previous day's close. This endpoint supports international equities, forex, and cryptocurrencies, enabling users to quickly identify significant market movements across various asset classes.
API credits cost
100 per request
✱ market
stringMaket type
Supports: stocks, etf, mutual_funds, forex, crypto
Example:
stocks
direction
stringSpecifies direction of the snapshot gainers or losers
Supports: gainers, losers
Default:
gainers
outputsize
integerSpecifies the size of the snapshot.
Can be in a range from 1 to 50
Default:
30
country
stringCountry of the snapshot, applicable to non-currencies only. Takes country name or alpha code
Default:
USA
price_greater_than
stringTakes values with price grater than specified value
Example:
175.5
dp
stringSpecifies the number of decimal places for floating values. Should be in range [0,11] inclusive
Default:
5
Request example
Response
{
"values": [
{
"symbol": "BSET",
"name": "Bassett Furniture Industries Inc",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"datetime": "2023-10-01 12:00:00Z",
"last": 17.25,
"high": 18,
"low": 16.5,
"volume": 108297,
"change": 3.31,
"percent_change": 23.74462
}
],
"status": "ok"
}Lookup static metadata—symbol lists, exchange details, currency information-to filter, validate, and contextualize your core data calls. Ideal for building dropdowns, mappings, and ensuring data consistency.
The stocks endpoint provides a daily updated list of all available stock symbols. It returns an array containing the symbols, which can be used to identify and access specific stock data across various services. This endpoint is essential for users needing to retrieve the latest stock symbol information for further data requests or integration into financial applications.
API credits cost
1 per request
symbol
stringThe ticker symbol of an instrument for which data is requested
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG000B9Y5X2
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
cik
stringThe CIK of an instrument for which data is requested
Example:
95953
exchange
stringFilter by exchange name
Example:
NASDAQ
mic_code
stringFilter by market identifier code (MIC) under ISO 10383 standard
Example:
XNGS
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
type
stringThe asset class to which the instrument belongs
Supports: American Depositary Receipt, Bond, Bond Fund, Closed-end Fund, Common Stock, Depositary Receipt, Digital Currency, ETF, Exchange-Traded Note, Global Depositary Receipt, Index, Limited Partnership, Mutual Fund, Physical Currency, Preferred Stock, REIT, Right, Structured Product, Trust, Unit, Warrant
Example:
Common Stock
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringThe separator used in the CSV response data
Default:
;
show_plan
booleanAdds info on which plan symbol is available
Default:
false
include_delisted
booleanInclude delisted identifiers
Default:
false
Request example
Response
{
"data": [
{
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNGS",
"country": "United States",
"type": "Common Stock",
"figi_code": "BBG000B9Y5X2",
"cfi_code": "ESVUFR",
"isin": "US0378331005",
"cusip": "037833100",
"access": {
"global": "Basic",
"plan": "Basic"
}
}
],
"status": "ok"
}The forex pairs endpoint provides a comprehensive list of all available foreign exchange currency pairs. It returns an array of forex pairs, which is updated daily.
API credits cost
1 per request
symbol
stringThe ticker symbol of an instrument for which data is requested
Example:
EUR/USD
currency_base
stringFilter by currency base
Example:
EUR
currency_quote
stringFilter by currency quote
Example:
USD
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringThe separator used in the CSV response data
Default:
;
Request example
Response
{
"data": [
{
"symbol": "EUR/USD",
"currency_group": "Major",
"currency_base": "EUR",
"currency_quote": "USD"
}
],
"status": "ok"
}The cryptocurrencies endpoint provides a daily updated list of all available cryptos. It returns an array containing detailed information about each cryptocurrency, including its symbol, name, and other relevant identifiers. This endpoint is useful for retrieving a comprehensive catalog of cryptocurrencies for applications that require up-to-date market listings or need to display available crypto assets to users.
API credits cost
1 per request
symbol
stringThe ticker symbol of an instrument for which data is requested
Example:
BTC/USD
exchange
stringFilter by exchange name. E.g. Binance, Coinbase, etc.
Example:
Binance
currency_base
stringFilter by currency base
Example:
BTC
currency_quote
stringFilter by currency quote
Example:
USD
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringThe separator used in the CSV response data
Default:
;
Request example
Response
{
"data": [
{
"symbol": "BTC/USD",
"available_exchanges": [
"ABCC",
"Allcoin",
"BTC-Alpha",
"BTCTurk",
"Bibox",
"n.exchange",
"p2pb2b",
"xBTCe"
],
"currency_base": "Bitcoin",
"currency_quote": "US Dollar"
}
],
"status": "ok"
}The ETFs endpoint provides a daily updated list of all available Exchange-Traded Funds. It returns an array containing detailed information about each ETF, including its symbol, name, and other relevant identifiers. This endpoint is useful for retrieving a comprehensive catalog of ETFs for portfolio management, investment tracking, or financial analysis.
API credits cost
1 per request
symbol
stringThe ticker symbol of an instrument for which data is requested
Example:
SPY
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG000BDTF76
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
cik
stringThe CIK of an instrument for which data is requested
Example:
95953
exchange
stringFilter by exchange name
Example:
NYSE
mic_code
stringFilter by market identifier code (MIC) under ISO 10383 standard
Example:
XNYS
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringThe separator used in the CSV response data
Default:
;
show_plan
booleanAdds info on which plan symbol is available
Default:
false
include_delisted
booleanInclude delisted identifiers
Default:
false
Request example
Response
{
"data": [
{
"symbol": "SPY",
"name": "SPDR S&P 500 ETF Trust",
"currency": "USD",
"exchange": "NYSE",
"mic_code": "ARCX",
"country": "United States",
"figi_code": "BBG000BDTF76",
"cfi_code": "CECILU",
"isin": "US78462F1030",
"cusip": "037833100",
"access": {
"global": "Basic",
"plan": "Basic"
}
}
],
"status": "ok"
}The funds endpoint provides a daily updated list of available investment funds. It returns an array containing detailed information about each fund, including identifiers, names, and other relevant attributes.
API credits cost
1 per request
symbol
stringThe ticker symbol of an instrument for which data is requested
Example:
FXAIX
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG000BHTMY7
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
cik
stringThe CIK of an instrument for which data is requested
Example:
95953
exchange
stringFilter by exchange name
Example:
Nasdaq
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringThe separator used in the CSV response data
Default:
;
show_plan
booleanAdds info on which plan symbol is available
Default:
false
page
integerPage number of the results to fetch
Default:
1
outputsize
integerDetermines the number of data points returned in the output
Default:
5000
Request example
Response
{
"result": {
"count": 84799,
"list": [
{
"symbol": "DIVI",
"name": "AdvisorShares Athena High Dividend ETF",
"country": "United States",
"currency": "USD",
"exchange": "NYSE",
"mic_code": "ARCX",
"type": "ETF",
"figi_code": "BBG00161BCW4",
"cfi_code": "CECILU",
"isin": "GB00B65TLW28",
"cusip": "35473P108",
"access": {
"global": "Basic",
"plan": "Basic"
}
}
]
},
"status": "ok"
}The commodities endpoint provides a daily updated list of available commodity pairs, across precious metals, livestock, softs, grains, etc.
API credits cost
1 per request
symbol
stringThe ticker symbol of an instrument for which data is requested
Example:
XAU/USD
category
stringFilter by category of commodity
Example:
Precious Metal
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringThe separator used in the CSV response data
Default:
;
Request example
Response
{
"data": [
{
"category": "Agricultural Product",
"description": "Standardized contract to buy or sell a set quantity of corn at a future date.",
"name": "Corn Futures",
"symbol": "C_1"
},
{
"category": "Agricultural Product",
"description": "Agreement to transact cocoa beans at a predetermined price and date.",
"name": "Cocoa Futures",
"symbol": "CC1"
},
{
"category": "Precious Metal",
"description": "Spot price per troy ounce of gold.",
"name": "Gold Spot",
"symbol": "XAU/USD"
}
],
"status": "ok"
}The fixed income endpoint provides a daily updated list of available bonds. It returns an array containing detailed information about each bond, including identifiers, names, and other relevant attributes.
API credits cost
1 per request
symbol
stringThe ticker symbol of an instrument for which data is requested
Example:
US2Y
exchange
stringFilter by exchange name
Example:
NYSE
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringThe separator used in the CSV response data
Default:
;
show_plan
booleanAdds info on which plan symbol is available
Default:
false
page
integerPage number of the results to fetch
Default:
1
outputsize
integerDetermines the number of data points returned in the output
Default:
5000
Request example
Response
{
"result": {
"count": 6,
"list": [
{
"symbol": "US2Y",
"name": "US Treasury Yield 2 Years",
"country": "United States",
"currency": "USD",
"exchange": "NYSE",
"mic_code": "XNYS",
"type": "Bond",
"access": {
"global": "Basic",
"plan": "Basic"
}
}
]
},
"status": "ok"
}The symbol search endpoint allows users to find financial instruments by name or symbol. It returns a list of matching symbols, ordered by relevance, with the most relevant instrument first. This is useful for quickly locating specific stocks, ETFs, or other financial instruments when only partial information is available.
API credits cost
1 per request
✱ symbol
stringSymbol to search. Supports:
Example:
AAPL
outputsize
integerNumber of matches in response. Max 120
Default:
30
show_plan
booleanAdds info on which plan symbol is available.
Default:
false
Request example
Response
{
"data": [
{
"symbol": "AA",
"instrument_name": "Alcoa Corp",
"exchange": "NYSE",
"mic_code": "XNYS",
"exchange_timezone": "America/New_York",
"instrument_type": "Common Stock",
"country": "United States",
"currency": "USD",
"access": {
"global": "Basic",
"plan": "Basic"
}
}
],
"status": "ok"
}The cross_listings endpoint provides a daily updated list of cross-listed symbols for a specified financial instrument. Cross-listed symbols represent the same security available on multiple exchanges. This endpoint is useful for identifying all the exchanges where a particular security is traded, allowing users to access comprehensive trading information across different markets.
API credits cost
40 per request
✱ symbol
stringThe ticker symbol of an instrument for which data is requested
Example:
AAPL
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket identifier code (MIC) under ISO 10383 standard
Example:
XNGS
country
stringCountry to which stock exchange belongs to
Example:
United States
Request example
Response
{
"result": {
"count": 4,
"list": [
{
"exchange": "NASDAQ",
"mic_code": "XNGS",
"name": "NVIDIA Corporation",
"symbol": "NVDA"
},
{
"exchange": "VSE",
"mic_code": "XWBO",
"name": "NVIDIA Corporation",
"symbol": "NVDA"
},
{
"exchange": "BVS",
"mic_code": "XSGO",
"name": "NVIDIA Corporation",
"symbol": "NVDACL"
},
{
"exchange": "BVS",
"mic_code": "XSGO",
"name": "NVIDIA Corporation",
"symbol": "NVDA"
}
]
}
}The earliest_timestamp endpoint provides the earliest available date and time for a specified financial instrument at a given data interval. This endpoint is useful for determining the starting point of historical data availability for various assets, such as stocks or currencies, allowing users to understand the time range covered by the data.
API credits cost
1 per request
symbol
stringSymbol ticker of the instrument.
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI).
Example:
BBG000B9XRY4
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
✱ interval
stringInterval between two consecutive points in time series.
Supports: 1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 1day, 1week, 1month
Example:
1day
exchange
stringExchange where instrument is traded.
Example:
Nasdaq
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard.
Example:
XNAS
timezone
stringTimezone at which output datetime will be displayed. Supports:
Exchange for local exchange timeUTC for datetime at universal UTC standardAmerica/New_York, Asia/Singapore. Full list of timezones can be found here.
Default:
Exchange
Response
{
"datetime": "1980-12-12",
"unix_time": 345479400
}The exchanges endpoint provides a comprehensive list of all available equity exchanges. It returns an array containing detailed information about each exchange, such as exchange code, name, country, and timezone. This data is updated daily.
API credits cost
1 per request
type
stringThe asset class to which the instrument belongs
Supports: American Depositary Receipt, Bond, Bond Fund, Closed-end Fund, Common Stock, Depositary Receipt, Digital Currency, ETF, Exchange-Traded Note, Global Depositary Receipt, Limited Partnership, Mutual Fund, Physical Currency, Preferred Stock, REIT, Right, Structured Product, Trust, Unit, Warrant
Example:
ETF
name
stringFilter by exchange name
Example:
NASDAQ
code
stringFilter by market identifier code (MIC) under ISO 10383 standard
Example:
XBUE
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringThe separator used in the CSV response data
Default:
;
show_plan
booleanAdds info on which plan symbol is available
Default:
false
Request example
Response
{
"data": [
{
"title": "Argentinian Stock Exchange",
"name": "BCBA",
"code": "XBUE",
"country": "Argentina",
"timezone": "America/Argentina/Buenos_Aires",
"access": {
"global": "Pro",
"plan": "Pro"
}
}
],
"status": "ok"
}The exchanges schedule endpoint provides detailed information about various stock exchanges, including their trading hours and operational days. This data is essential for users who need to know when specific exchanges are open for trading, allowing them to plan their activities around the availability of these markets.
API credits cost
100 per request
date
stringIf a date is provided, the API returns the schedule for the specified date; otherwise, it returns the default (common) schedule.
The date can be specified in one of the following formats:2021-10-27)today or yesterday2025-04-11T20:00:00) to retrieve the schedule corresponding to the day in the specified time.2025-04-11T20:00:00 UTC corresponds to:
2025-04-11 in the America/New_York timezone2025-04-12 in the Australia/Sydney timezone
Example:
2021-10-27
mic_name
stringFilter by exchange name
Example:
NASDAQ
mic_code
stringFilter by market identifier code (MIC) under ISO 10383 standard
Example:
XNGS
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
Request example
Response
{
"data": [
{
"title": "NASDAQ/NGS (Global Select Market)",
"name": "NASDAQ",
"code": "XNYS",
"country": "United States",
"time_zone": "America/New_York",
"sessions": [
{
"open_time": "04:00:00",
"close_time": "09:30:00",
"session_name": "Pre market",
"session_type": "pre"
}
]
}
]
}The cryptocurrency exchanges endpoint provides a daily updated list of available cryptocurrency exchanges. It returns an array containing details about each exchange, such as exchange names and identifiers.
API credits cost
1 per request
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringSpecify the delimiter used when downloading the CSV file
Default:
;
Request example
Response
{
"data": [
{
"name": "Binance"
},
{
"name": "Coinbase Pro"
},
{
"name": "Kraken"
},
{
"name": "OKX"
}
],
"status": "ok"
}The market state endpoint provides real-time information on the operational status of all available stock exchanges. It returns data on whether each exchange is currently open or closed, along with the time remaining until the next opening or closing. This endpoint is useful for users who need to monitor exchange hours and plan their trading activities accordingly.
API credits cost
1 per request
exchange
stringThe exchange name where the instrument is traded.
Example:
NYSE
code
stringThe Market Identifier Code (MIC) of the exchange where the instrument is traded.
Example:
XNYS
country
stringThe country where the exchange is located. Takes country name or alpha code.
Example:
United States
Request example
Response
[
{
"name": "NYSE",
"code": "XNYS",
"country": "United States",
"is_market_open": true,
"time_after_open": "02:39:03",
"time_to_open": "00:00:00",
"time_to_close": "05:20:57"
}
]The countries endpoint provides a comprehensive list of countries, including their ISO codes, official names, capitals, and currencies. This data is essential for applications requiring accurate country information for tasks such as localization, currency conversion, or geographic analysis.
API credits cost
1 per request
Request example
Response
{
"data": [
{
"iso2": "US",
"iso3": "USA",
"numeric": "840",
"name": "United States",
"official_name": "United States of America",
"capital": "Washington D.C.",
"currency": "USD"
}
]
}The instrument type endpoint lists all available financial instrument types, such as stocks, ETFs, and cryptos. This information is essential for users to identify and categorize different financial instruments when accessing or analyzing market data.
API credits cost
1 per request
Request example
Response
{
"result": [
"Agricultural Product",
"American Depositary Receipt",
"Bond",
"Bond Fund",
"Closed-end Fund",
"Common Stock",
"Depositary Receipt",
"Digital Currency",
"Energy Resource",
"ETF",
"Exchange-Traded Note",
"Global Depositary Receipt",
"Index",
"Industrial Metal",
"Limited Partnership",
"Livestock",
"Mutual Fund",
"Physical Currency",
"Precious Metal",
"Preferred Stock",
"REIT",
"Right",
"Structured Product",
"Trust",
"Unit",
"Warrant"
],
"status": "ok"
}The technical indicators endpoint provides a comprehensive list of available technical indicators, each represented as an object. This endpoint is useful for developers looking to integrate a variety of technical analysis tools into their applications, allowing for streamlined access to indicator data without needing to manually configure each one.
API credits cost
1 per request
Request example
Response
{
"data": {
"macd": {
"enable": true,
"full_name": "Moving Average Convergence Divergence",
"description": "Moving Average Convergence Divergence(MACD) is ...",
"type": "Momentum Indicators",
"overlay": false,
"output_values": {
"parameter_name": {
"default_color": "#FF0000",
"display": "line",
"min_range": 0,
"max_range": 5
}
},
"parameters": {
"parameter_name": {
"default": 12,
"max_range": 1,
"min_range": 1,
"range": [
"open",
"high",
"low",
"close"
],
"type": "int"
}
},
"tinting": {
"display": "fill",
"color": "#FF0000",
"transparency": 0.5,
"lower_bound": "0",
"upper_bound": "macd"
}
}
},
"status": "ok"
}In-depth company and fund financials—income statements, balance sheets, cash flows, profiles, corporate events, and key ratios. Unlock comprehensive datasets for valuation, screening, and fundamental research.
The logo endpoint provides the official logo image for a specified company, cryptocurrency, or forex pair. This endpoint is useful for integrating visual branding elements into financial applications, websites, or reports, ensuring that users can easily identify and associate the correct logo with the respective financial asset.
API credits cost
1 per symbol
✱ symbol
stringThe ticker symbol of an instrument for which data is requested, e.g., AAPL, BTC/USD, EUR/USD.
Example:
BTC/USD
exchange
stringThe exchange name where the instrument is traded, e.g., NASDAQ, NSE
Example:
NASDAQ
mic_code
stringThe Market Identifier Code (MIC) of the exchange where the instrument is traded, e.g., XNAS, XLON
Example:
XNAS
country
stringThe country where the instrument is traded, e.g., United States or US
Example:
United States
Request example
Response
{
"meta": {
"symbol": "BTC/USD",
"exchange": "Coinbase Pro"
},
"url": "https://api.twelvedata.com/logo/apple.com",
"logo_base": "https://logo.twelvedata.com/crypto/btc.png",
"logo_quote": "https://logo.twelvedata.com/crypto/usd.png"
}The profile endpoint provides detailed company information, including the company's name, industry, sector, CEO, headquarters location, and market capitalization. This data is useful for obtaining a comprehensive overview of a company's business and financial standing.
API credits cost
10 per symbol
symbol
stringSymbol ticker of instrument. For preffered stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG01293F5X4
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
Request example
Response
{
"symbol": "AAPL",
"name": "Apple Inc",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"sector": "Technology",
"industry": "Consumer Electronics",
"employees": 147000,
"website": "http://www.apple.com",
"description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and...",
"type": "Common Stock",
"CEO": "Mr. Timothy D. Cook",
"address": "One Apple Park Way",
"address2": "Cupertino, CA 95014",
"city": "Cupertino",
"zip": "95014",
"state": "CA",
"country": "US",
"phone": "408-996-1010"
}The dividends endpoint provides historical dividend data for a specified stock, in many cases covering over a decade. It returns information on dividend payouts, including the amount, payment date, and frequency. This endpoint is ideal for users tracking dividend histories or evaluating the income potential of stocks.
API credits cost
20 per symbol
symbol
stringSymbol ticker of instrument. For preffered stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG01293F5X4
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
US
range
stringSpecifies the time range for which to retrieve dividend data.
Accepts values such as last (most recent dividend), next (upcoming dividend),
1m - 5y for respective periods, or full for all available data.
If provided together with start_date and/or end_date, this parameter takes precedence.
Supports: last, next, 1m, 3m, 6m, ytd, 1y, 2y, 5y, full
Default:
last
start_date
stringStart date for the dividend data query. Only dividends with dates on or after this date will be returned. Format 2006-01-02.
If provided together with range parameter, range will take precedence.
Example:
2024-01-01
end_date
stringEnd date for the dividend data query. Only dividends with dates on or after this date will be returned. Format 2006-01-02.
If provided together with range parameter, range will take precedence.
Example:
2024-12-31
adjust
booleanSpecifies if there should be an adjustment
Default:
true
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York"
},
"dividends": [
{
"ex_date": "2021-08-06",
"amount": 0.22
}
]
}The dividends calendar endpoint provides a detailed schedule of upcoming and past dividend events for specified date ranges. By using the start_date and end_date parameters, users can retrieve a list of companies issuing dividends, including the ex-dividend date, payment date, and dividend amount. This endpoint is ideal for tracking dividend payouts and planning investment strategies based on dividend schedules.
API credits cost
40 per symbol
symbol
stringSymbol ticker of instrument. For preffered stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG01293F5X4
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
US
start_date
stringStart date for the dividends calendar query. Only dividends with ex-dates on or after this date will be returned. Format 2006-01-02
Example:
2024-01-01
end_date
stringEnd date for the dividends calendar query. Only dividends with ex-dates on or before this date will be returned. Format 2006-01-02
Example:
2024-12-31
outputsize
integerNumber of data points to retrieve.
Supports values in the range from 1 to 500.
Default 100 when no date parameters are set, otherwise set to maximum
Default:
100
page
integerPage number
Default:
1
Request example
Response
[
{
"symbol": "MSFT",
"mic_code": "XNGS",
"exchange": "NASDAQ",
"ex_date": "2024-02-14",
"amount": 0.75
}
]The splits endpoint provides historical data on stock split events for a specified company. It returns details including the date of each split and the corresponding split factor.
API credits cost
20 per symbol
symbol
stringSymbol ticker of instrument. For preffered stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG01293F5X4
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
range
stringRange of data to be returned
Supports: last, 1m, 3m, 6m, ytd, 1y, 2y, 5y, full
Default:
last
start_date
stringThe starting date for data selection. Format 2006-01-02
Example:
2020-01-01
end_date
stringThe ending date for data selection. Format 2006-01-02
Example:
2020-12-31
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York"
},
"splits": [
{
"date": "2020-08-31",
"description": "4-for-1 split",
"ratio": 0.25,
"from_factor": 4,
"to_factor": 1
}
]
}The splits calendar endpoint provides a detailed calendar of stock split events within a specified date range. By setting the start_date and end_date parameters, users can retrieve a list of upcoming or past stock splits, including the company name, split ratio, and effective date. This endpoint is useful for tracking changes in stock structure and planning investment strategies around these events.
API credits cost
40 per symbol
symbol
stringSymbol ticker of instrument. For preffered stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG01293F5X4
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
start_date
stringThe starting date (inclusive) for filtering split events in the calendar. Format 2006-01-02
Example:
2024-01-01
end_date
stringThe ending date (inclusive) for filtering split events in the calendar. Format 2006-01-02
Example:
2024-12-31
outputsize
integerNumber of data points to retrieve. Supports values in the range from 1 to 500. Default 100 when no date parameters are set, otherwise set to maximum
Default:
100
page
stringPage number
Default:
1
Request example
Response
[
{
"date": "1987-06-16",
"symbol": "AAPL",
"mic_code": "XNGS",
"exchange": "NASDAQ",
"description": "2-for-1 split",
"ratio": 0.5,
"from_factor": 2,
"to_factor": 1
}
]The earnings endpoint provides comprehensive earnings data for a specified company, including both the estimated and actual Earnings Per Share (EPS) figures. This endpoint delivers historical earnings information, allowing users to track a company's financial performance over time.
API credits cost
20 per symbol
symbol
stringSymbol ticker of instrument.
For preffered stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG01293F5X4
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
type
stringThe asset class to which the instrument belongs
Supports: American Depositary Receipt, Bond, Bond Fund, Closed-end Fund, Common Stock, Depositary Receipt, Digital Currency, ETF, Exchange-Traded Note, Global Depositary Receipt, Limited Partnership, Mutual Fund, Physical Currency, Preferred Stock, REIT, Right, Structured Product, Trust, Unit, Warrant
Example:
Common Stock
period
stringType of earning, returns only 1 record. When is not empty, dates and outputsize parameters are ignored
Supports: latest, next
outputsize
integerNumber of data points to retrieve.
Supports values in the range from 1 to 1000.
Default 10 when no date parameters are set, otherwise set to maximum
Default:
10
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringThe separator used in the CSV response data
Default:
;
dp
integerThe number of decimal places in the response data. Should be in range [0,11] inclusive
Default:
2
start_date
stringThe date from which the data is requested. The date format is YYYY-MM-DD.
Example:
2024-04-01
end_date
stringThe date to which the data is requested. The date format is YYYY-MM-DD.
Example:
2024-04-30
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York"
},
"earnings": [
{
"date": "2020-04-30",
"time": "After Hours",
"eps_estimate": 2.09,
"eps_actual": 2.55,
"difference": 0.46,
"surprise_prc": 22.01
}
],
"status": "ok"
}The earnings calendar endpoint provides a schedule of company earnings announcements for a specified date range. By default, it returns earnings data for the current day. Users can customize the date range using the start_date and end_date parameters to retrieve earnings information for specific periods. This endpoint is useful for tracking upcoming earnings reports and planning around key financial announcements.
API credits cost
40 per request
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
format
stringValue can be JSON or CSV
Supports: JSON, CSV
Default:
JSON
delimiter
stringSpecify the delimiter used when downloading the CSV file
Default:
;
dp
integerSpecifies the number of decimal places for floating values. Should be in range [0,11] inclusive
Default:
2
start_date
stringCan be used separately and together with end_date.
Format 2006-01-02 or 2006-01-02T15:04:05
Example:
2024-04-01
end_date
stringCan be used separately and together with start_date.
Format 2006-01-02 or 2006-01-02T15:04:05
Example:
2024-04-30
Request example
Response
{
"earnings": {
"2020-04-30": [
{
"symbol": "BR",
"name": "Broadridge Financial Solutions Inc",
"currency": "USD",
"exchange": "NYSE",
"mic_code": "XNYS",
"country": "United States",
"time": "Time Not Supplied",
"eps_estimate": 1.72,
"eps_actual": 1.67,
"difference": -0.05,
"surprise_prc": -2.9
}
]
},
"status": "ok"
}The IPO Calendar endpoint provides detailed information on initial public offerings (IPOs), including those that have occurred in the past, are happening today, or are scheduled for the future. Users can access data such as company names, IPO dates, and offering details, allowing them to track and monitor IPO activity efficiently.
API credits cost
40 per request
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
start_date
stringThe earliest IPO date to include in the results. Format: 2006-01-02
Example:
2021-01-01
end_date
stringThe latest IPO date to include in the results. Format: 2006-01-02
Example:
2021-12-31
Request example
Response
{
"2025-07-16": [
{
"symbol": "DWACU",
"name": "Digital World Acquisition Corp.",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"price_range_low": 10,
"price_range_high": 10,
"offer_price": 0,
"currency": "USD",
"shares": 0
}
]
}The statistics endpoint provides a comprehensive snapshot of a company's key financial statistics, including valuation metrics, revenue figures, profit margins, and other essential financial data. This endpoint is ideal for users seeking detailed insights into a company's financial health and performance metrics.
API credits cost
50 per symbol
symbol
stringSymbol ticker of instrument.
For preffered stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG000B9Y5X2
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York"
},
"statistics": {
"valuations_metrics": {
"market_capitalization": 2546807865344,
"enterprise_value": 2620597731328,
"trailing_pe": 30.162493,
"forward_pe": 26.982489,
"peg_ratio": 1.4,
"price_to_sales_ttm": 7.336227,
"price_to_book_mrq": 39.68831,
"enterprise_to_revenue": 7.549,
"enterprise_to_ebitda": 23.623
},
"financials": {
"fiscal_year_ends": "2020-09-26",
"most_recent_quarter": "2021-06-26",
"gross_margin": 46.57807,
"profit_margin": 0.25004,
"operating_margin": 0.28788,
"return_on_assets_ttm": 0.19302,
"return_on_equity_ttm": 1.27125,
"income_statement": {
"revenue_ttm": 347155005440,
"revenue_per_share_ttm": 20.61,
"quarterly_revenue_growth": 0.364,
"gross_profit_ttm": 104956000000,
"ebitda": 110934999040,
"net_income_to_common_ttm": 86801997824,
"diluted_eps_ttm": 5.108,
"quarterly_earnings_growth_yoy": 0.932
},
"balance_sheet": {
"total_cash_mrq": 61696000000,
"total_cash_per_share_mrq": 3.732,
"total_debt_mrq": 135491002368,
"total_debt_to_equity_mrq": 210.782,
"current_ratio_mrq": 1.062,
"book_value_per_share_mrq": 3.882
},
"cash_flow": {
"operating_cash_flow_ttm": 104414003200,
"levered_free_cash_flow_ttm": 80625876992
}
},
"stock_statistics": {
"shares_outstanding": 16530199552,
"float_shares": 16513305231,
"avg_10_volume": 72804757,
"avg_90_volume": 77013078,
"shares_short": 93105968,
"short_ratio": 1.19,
"short_percent_of_shares_outstanding": 0.0056,
"percent_held_by_insiders": 0.00071000005,
"percent_held_by_institutions": 0.58474
},
"stock_price_summary": {
"fifty_two_week_low": 103.1,
"fifty_two_week_high": 157.26,
"fifty_two_week_change": 0.375625,
"beta": 1.201965,
"day_50_ma": 148.96686,
"day_200_ma": 134.42506
},
"dividends_and_splits": {
"forward_annual_dividend_rate": 0.88,
"forward_annual_dividend_yield": 0.0057,
"trailing_annual_dividend_rate": 0.835,
"trailing_annual_dividend_yield": 0.0053832764,
"5_year_average_dividend_yield": 1.27,
"payout_ratio": 0.16309999,
"dividend_frequency": "Quarterly",
"dividend_date": "2021-08-12",
"ex_dividend_date": "2021-08-06",
"last_split_factor": "4-for-1 split",
"last_split_date": "2020-08-31"
}
}
}The income statement endpoint provides detailed financial data on a company's income statement, including revenues, expenses, and net income for specified periods, either annually or quarterly. This endpoint is essential for retrieving comprehensive financial performance metrics of a company, allowing users to access historical and current financial results.
API credits cost
100 per symbol
symbol
stringSymbol ticker of instrument.
For preffered stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG01293F5X4
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
period
stringThe reporting period for the income statement data
Supports: annual, quarterly
Example:
annual
start_date
stringBegin date for filtering income statements by fiscal date.
Returns income statements with fiscal dates on or after this date.
Format 2006-01-02
Example:
2024-01-01
end_date
stringEnd date for filtering income statements by fiscal date.
Returns income statements with fiscal dates on or before this date.
Format 2006-01-02
Example:
2024-12-31
outputsize
integerNumber of records in response
Default:
6
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"exchange_timezone": "America/New_York",
"period": "Quarterly"
},
"income_statement": [
{
"fiscal_date": "2021-12-31",
"quarter": 1,
"year": 2022,
"sales": 123945000000,
"cost_of_goods": 69702000000,
"gross_profit": 54243000000,
"operating_expense": {
"research_and_development": 6306000000,
"selling_general_and_administrative": 6449000000,
"other_operating_expenses": 0
},
"operating_income": 41488000000,
"non_operating_interest": {
"income": 650000000,
"expense": 694000000
},
"other_income_expense": -203000000,
"pretax_income": 41241000000,
"income_tax": 6611000000,
"net_income": 34630000000,
"eps_basic": 2.11,
"eps_diluted": 2.1,
"basic_shares_outstanding": 16391724000,
"diluted_shares_outstanding": 16391724000,
"ebit": 41488000000,
"ebitda": 44632000000,
"net_income_continuous_operations": 0,
"minority_interests": 0,
"preferred_stock_dividends": 0
}
]
}The income statement consolidated endpoint provides a company's raw income statement, detailing revenue, expenses, and net income for specified periods, either annually or quarterly. This data is essential for evaluating a company's financial performance over time, allowing users to access comprehensive financial results in a structured format.
API credits cost
100 per symbol
symbol
stringSymbol ticker of instrument.
For preffered stocks use dot(.) delimiter.
E.g. BRK.A or BRK.B will be correct
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI)
Example:
BBG01293F5X4
isin
stringFilter by international securities identification number (ISIN)
Example:
US0378331005
cusip
stringThe CUSIP of an instrument for which data is requested. CUSIP access is activating in the Add-ons section
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringMarket Identifier Code (MIC) under ISO 10383 standard
Example:
XNAS
country
stringCountry where instrument is traded, e.g., United States or US
Example:
United States
period
stringThe reporting period for the income statement data
Supports: annual, quarterly
start_date
stringBegin date for filtering income statements by fiscal date.
Returns income statements with fiscal dates on or after this date.
Format 2006-01-02
Example:
2024-01-01
end_date
stringEnd date for filtering income statements by fiscal date.
Returns income statements with fiscal dates on or before this date.
Format 2006-01-02
Example:
2024-12-31
outputsize
integerNumber of records in response
Default:
6
Response
{
"income_statement": [
{
"fiscal_date": "2023-09-30",
"year": 2022,
"revenue": {
"total_revenue": 383285000000,
"operating_revenue": 383285000000
},
"gross_profit": {
"gross_profit_value": 169148000000,
"cost_of_revenue": {
"cost_of_revenue_value": 214137000000,
"excise_taxes": 214137000000,
"reconciled_cost_of_revenue": 214137000000
}
},
"operating_income": {
"operating_income_value": 114301000000,
"total_operating_income_as_reported": 114301000000,
"operating_expense": 54847000000,
"other_operating_expenses": 114301000000,
"total_expenses": 268984000000
},
"net_income": {
"net_income_value": 96995000000,
"net_income_common_stockholders": 96995000000,
"net_income_including_noncontrolling_interests": 96995000000,
"net_income_from_tax_loss_carryforward": 96995000000,
"net_income_extraordinary": 96995000000,
"net_income_discontinuous_operations": 96995000000,
"net_income_continuous_operations": 96995000000,
"net_income_from_continuing_operation_net_minority_interest": 96995000000,
"net_income_from_continuing_and_discontinued_operation": 96995000000,
"normalized_income": 96995000000,
"minority_interests": 96995000000
},
"earnings_per_share": {
"diluted_eps": 6.13,
"basic_eps": 6.16,
"continuing_and_discontinued_diluted_eps": 6.16,
"continuing_and_discontinued_basic_eps": 6.16,
"normalized_diluted_eps": 6.16,
"normalized_basic_eps": 6.16,
"reported_normalized_diluted_eps": 6.16,
"reported_normalized_basic_eps": 6.16,
"diluted_eps_other_gains_losses": 6.16,
"tax_loss_carryforward_diluted_eps": 6.16,
"diluted_accounting_change": 6.16,
"diluted_extraordinary": 6.16,
"diluted_discontinuous_operations": 6.16,
"diluted_continuous_operations": 6.16,
"basic_eps_other_gains_losses": 6.16,
"tax_loss_carryforward_basic_eps": 6.16,
"basic_accounting_change": 6.16,
"basic_extraordinary": 6.16,
"basic_discontinuous_operations": 6.16,
"basic_continuous_operations": 6.16,
"diluted_ni_avail_to_common_stockholders": 96995000000,
"average_dilution_earnings": 96995000000
},
"expenses": {
"total_expenses": 268984000000,
"selling_general_and_administration_expense": 24932000000,
"selling_and_marketing_expense": 24932000000,
"general_and_administrative_expense": 24932000000,
"other_general_and_administrative_expense": 24932000000,
"depreciation_amortization_depletion_income_statement": 29915000000,
"research_and_development_expense": 29915000000,
"insurance_and_claims_expense": 29915000000,
"rent_and_landing_fees": 29915000000,
"salaries_and_wages_expense": 29915000000,
"rent_expense_supplemental": 29915000000,
"provision_for_doubtful_accounts": 29915000000
},
"interest_income_and_expense": {
"interest_income": 3750000000,
"interest_expense": 3933000000,
"net_interest_income": -183000000,
"net_non_operating_interest_income_expense": -183000000,
"interest_expense_non_operating": 3933000000,
"interest_income_non_operating": 3750000000
},
"other_income_and_expenses": {
"other_income_expense": -382000000,
"other_non_operating_income_expenses": -382000000,
"special_income_charges": 382000000,
"gain_on_sale_of_ppe": 382000000,
"gain_on_sale_of_business": 382000000,
"gain_on_sale_of_security": 382000000,
"other_special_charges": 382000000,
"write_off": 382000000,
"impairment_of_capital_assets": 382000000,
"restructuring_and_merger_acquisition": 382000000,
"securities_amortization": 382000000,
"earnings_from_equity_interest": 382000000,
"earnings_from_equity_interest_net_of_tax": 382000000,
"total_other_finance_cost": 382000000
},
"taxes": {
"tax_provision": 16741000000,
"tax_effect_of_unusual_items": 0,
"tax_rate_for_calculations": 0.147,
"other_taxes": 0
},
"depreciation_and_amortization": {
"depreciation_amortization_depletion": 129188000000,
"amortization_of_intangibles": 129188000000,
"depreciation": 129188000000,
"amortization": 129188000000,
"depletion": 129188000000,
"depreciation_and_amortization_in_income_statement": 129188000000
},
"ebitda": {
"ebitda_value": 129188000000,
"normalized_ebitda_value": 129188000000,
"ebit_value": 117669000000
},
"dividends_and_shares": {
"dividend_per_share": 15812547000,
"diluted_average_shares": 15812547000,
"basic_average_shares": 15744231000,
"preferred_stock_dividends": 15744231000,
"other_under_preferred_stock_dividend": 15744231000
},
"unusual_items": {
"total_unusual_items": 11519000000,
"total_unusual_items_excluding_goodwill": 11519000000
},
"depreciation": {
"reconciled_depreciation": 11519000000
},
"pretax_income": {
"pretax_income_value": 113736000000
},
"special_income_charges": {
"special_income_charges_value": 113736000000
}
}
],
"status": "ok"
}The balance sheet endpoint provides a detailed financial statement for a company, outlining its assets, liabilities, and shareholders' equity. This endpoint returns structured data that includes current and non-current assets, total liabilities, and equity figures, enabling users to assess a company's financial health and stability.
API credits cost
100 per symbol