Twelve Data

Overview

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.

Quickstart

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.

Step 1: Create Twelve Data account

Sign up on the Twelve Data website to create your account here. This gives you access to the API dashboard and your API key.

Step 2: Get 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.

Step 3: Make your first request

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"

Step 4: Make a request from Python or Javascript

Use our client libraries or standard HTTP clients to make API calls programmatically. Here’s an example in Python and Node.js:

Python (using official Twelve Data SDK):

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)

JavaScript (Node.js):

import { MarketDataApi, CreateConfig } from "@twelvedata/twelvedata-node";
const config = CreateConfig('your_api_key');
const api = new MarketDataApi(config);
async function main() {
  const response = await api.getPrice({
    symbol: "AAPL",
  });
  console.log(response.data);
}
main().catch(console.error);

Step 5: Perform correlation analysis between Tesla and Microsoft prices

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}")

Authentication

Authenticate your requests using one of these methods:

Query parameter method

GET https://api.twelvedata.com/endpoint?symbol=AAPL&apikey=your_api_key

HTTP header method (recommended)

Authorization: apikey your_api_key
API key useful information
  • Demo API key (apikey=demo) available for demo requests
  • Personal API key required for full access
  • Premium endpoints and data require higher-tier plans (testable with trial symbols)

API endpoints

Service Base URL
REST API https://api.twelvedata.com
WebSocket wss://ws.twelvedata.com

Parameter guidelines

  • Separator: Use & to separate multiple parameters
  • Case sensitivity: Parameter names are case-insensitive (symbol=AAPL = symbol=aapl)
  • Multiple values: Separate with commas where supported

Response handling

Default format

All responses return JSON format by default unless otherwise specified.

Null values

Important: Some response fields may contain null values when data is unavailable for specific metrics. This is expected behavior, not an error.

Best Practices:
  • Always implement null value handling in your application
  • Use defensive programming techniques for data processing
  • Consider fallback values or error handling for critical metrics

Error handling

Structure your code to gracefully handle:

  • Network timeouts
  • Rate limiting responses
  • Invalid parameter errors
  • Data unavailability periods
Best practices
  • Rate limits: Adhere to your plan’s rate limits to avoid throttling. Check your dashboard for details.
  • Error handling: Implement retry logic for transient errors (e.g., 429 Too Many Requests).
  • Caching: Cache responses for frequently accessed data to reduce API calls and improve performance.
  • Secure storage: Store your API key securely and never expose it in client-side code or public repositories.

Errors

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.

Codes

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 Documenta­tion to correct the input.
401 Unauthor­ized 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.

Example error response

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.

Libraries

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.

Official SDKs

AI integrations

  • Twelve Data MCP Server: Repository — Model Context Protocol (MCP) server that provides seamless integration with AI assistants and language models, enabling direct access to Twelve Data's financial market data within conversational interfaces and AI workflows.
  • Twelve Data integration for OpenClaw: Clawhub skill — Integration for the OpenClaw platform, allowing users to leverage Twelve Data's API within their OpenClaw applications.
  • Twelve Data NEAR Agent: NEAR Agent — Access Twelve Data's API directly from NEAR's AI agent platform, enabling users to retrieve financial data and insights within their NEAR AI agent workflows.

Spreadsheet add-ons

Community libraries

The community has developed libraries in several popular languages. You can explore more community libraries on GitHub.

Other Twelve Data repositories

  • searchindex (Go): Repository — In-memory search index by strings
  • ws-tools (Python): Repository — Utility tools for WebSocket stream handling

API specification

  • OpenAPI / Swagger: Access the complete API specification in OpenAPI format. You can use this file to automatically generate client libraries in your preferred programming language, explore the API interactively via Swagger tools, or integrate Twelve Data seamlessly into your AI and LLM workflows.

Market data

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.

Time series High demand

/time_series

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

One of these parameters is required

symbol

string

Symbol ticker of the instrument. E.g. AAPL, EUR/USD, ETH/BTC, ...

Example: AAPL

figi

string

The FIGI of an instrument for which data is requested. This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

interval

string

Interval between two consecutive points in time series

Supports: 1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 8h, 1day, 1week, 1month

Example: 1min

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

The country where the instrument is traded, e.g., United States or US

Example: United States

type

string

The 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

integer

Number 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

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

prepost

boolean

Returns quotes that include pre-market and post-market data. Only for the Pro plan (individual) and Venture plan (business) and above. Available at the 1min, 5min, 15min, and 30min intervals for US equities. Open, high, low, close values are supplied without volume

Default: false

dp

integer

Specifies 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

string

Sorting order of the output

Supports: asc, desc

Default: desc

timezone

string

Timezone at which output datetime will be displayed. Supports:

  • 1. Exchange for local exchange time
  • 2. UTC for datetime at universal UTC standard
  • 3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here

Interval Limitation: The timezone parameter is only applicable for intraday intervals (less than 1 day). For intervals of 1day, 1week, or 1month, the timezone parameter is ignored, and data is strictly returned in the Exchange local time.

Take note that the IANA Timezone name is case-sensitive

Default: Exchange

date

string

Specifies 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

string

Can be used separately and together with end_date. Format 2006-01-02 or 2006-01-02T15:04:05

Default location:

  • Forex and Cryptocurrencies - UTC
  • Stocks - where exchange is located (e.g. for AAPL it will be America/New_York)

Both parameters take into account if timezone parameter is provided.
If timezone is given then, start_date and end_date will be used in the specified location

Examples:

  • 1. &symbol=AAPL&start_date=2019-08-09T15:50:00&…
    Returns all records starting from 2019-08-09T15:50:00 New York time up to current date
  • 2. &symbol=EUR/USD&timezone=Asia/Singapore&start_date=2019-08-09T15:50:00&…
    Returns all records starting from 2019-08-09T15:50:00 Singapore time up to current date
  • 3. &symbol=ETH/BTC&timezone=Europe/Zurich&start_date=2019-08-09T15:50:00&end_date=2019-08-09T15:55:00&...
    Returns all records starting from 2019-08-09T15:50:00 Zurich time up to 2019-08-09T15:55:00

Example: 2024-08-22T15:04:05

end_date

string

The ending date and time for data selection, see start_date description for details.

Example: 2024-08-22T16:04:05

previous_close

boolean

A 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

string

Adjusting 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"
}

Time series cross

/time_series/cross

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 request

base

string

Base currency symbol

Example: JPY

base_type

string

Base instrument type according to the /instrument_type endpoint

Example: Physical Currency

base_exchange

string

Base exchange

Example: Binance

base_mic_code

string

Base MIC code

Example: XNGS

quote

string

Quote currency symbol

Example: BTC

quote_type

string

Quote instrument type according to the /instrument_type endpoint

Example: Digital Currency

quote_exchange

string

Quote exchange

Example: Coinbase

quote_mic_code

string

Quote MIC code

Example: XNYS

interval

string

Interval between two consecutive points in time series

Supports: 1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 8h, 1day, 1week, 1month

Example: 1min

outputsize

integer

Number 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

string

Format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

Delimiter used in CSV file

Default: ;

prepost

boolean

Only for the Pro plan (individual) and Venture plan (business) and above. 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

string

Start date for the time series data

Example: 2025-01-01

end_date

string

End date for the time series data

Example: 2025-01-31

adjust

boolean

Specifies if there should be an adjustment

Default: true

dp

integer

Specifies the number of decimal places for floating values. Should be in range [0, 11] inclusive.

Default: 5

timezone

string

Timezone at which output datetime will be displayed. Supports:

  • 1. Exchange for local exchange time
  • 2. UTC for datetime at universal UTC standard
  • 3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here.

Take note that the IANA Timezone name is case-sensitive

Example: UTC

Request example

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"
        }
    ]
}

Quote High demand

/quote

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

One of these parameters is required

symbol

string

Symbol ticker of the instrument

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BHTMY7

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

interval

string

Interval of the quote

Supports: 1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 8h, 1day, 1week, 1month

Default: 1day

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

volume_time_period

integer

Number of periods for Average Volume

Default: 9

type

string

The 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

string

Value can be JSON or CSV Default JSON

Supports: JSON, CSV

Default: JSON

delimiter

string

Specify the delimiter used when downloading the CSV file

Default: ;

prepost

boolean

Parameter is optional. Only for the Pro plan (individual) and Venture plan (business) and above. Available at the 1min, 5min, 15min, and 30min intervals for US equities. Open, high, low, close values are supplied without volume.

Default: false

eod

boolean

If true, then return data for closed day

Supports: true, false

Default: false

rolling_period

integer

Number of hours for calculate rolling change at period. By default set to 24, it can be in range [1, 168].

Default: 24

dp

integer

Specifies the number of decimal places for floating values Should be in range [0,11] inclusive

Default: 5

timezone

string

Timezone at which output datetime will be displayed. Supports:

  • 1. Exchange for local exchange time
  • 2. UTC for datetime at universal UTC standard
  • 3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here.

Interval Limitation: The timezone parameter is only applicable for intraday intervals (less than 1 day). For intervals of 1day, 1week, or 1month, the timezone parameter is ignored, and data is strictly returned in the Exchange local time.

Take note that the IANA Timezone name is case-sensitive

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
}

Latest price High demand

/price

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

One of these parameters is required

symbol

string

Symbol ticker of the instrument

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BHTMY7

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

type

string

The 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

string

Value can be JSON or CSV

Supports: JSON, CSV

Default: JSON

delimiter

string

Specify the delimiter used when downloading the CSV file

Default: ;

prepost

boolean

Parameter is optional. Only for Pro or Venture, 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

integer

Specifies the number of decimal places for floating values. Should be in range [0,11] inclusive

Default: 5

Request example

Response

{
    "price": "200.99001"
}

End of day price

/eod

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

One of these parameters is required

symbol

string

Symbol ticker of the instrument

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BHTMY7

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

type

string

The 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

string

If not null, then return data from a specific date

Example: 2006-01-02

prepost

boolean

Parameter is optional. Only for the Pro plan (individual) and Venture plan (business) and above. Available at the 1min, 5min, 15min, and 30min intervals for US equities. Open, high, low, close values are supplied without volume

Default: false

dp

integer

Specifies 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"
}

Market movers

/market_movers/{market}

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

This API endpoint is available on the Pro plan (individual) and the Venture plan (business) and above.

market

string

Market type

Supports: stocks, etf, mutual_funds, forex, crypto

Example: stocks

direction

string

Specifies direction of the snapshot gainers or losers

Supports: gainers, losers

Default: gainers

outputsize

integer

Specifies the size of the snapshot. Can be in a range from 1 to 50

Default: 30

country

string

Country of the snapshot, applicable to non-currencies only. Takes country name or alpha code

Default: USA

price_greater_than

string

Takes values with price grater than specified value

Example: 175.5

dp

string

Specifies 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"
}

Reference data

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.

Asset catalogs

Asset Catalog endpoints are your starting point. They return the complete inventory of tradeable instruments available through Twelve Data — over 1,000,000 symbols across 50+ countries. You query a catalog first to discover which symbols exist, then pass those symbols to price, fundamental, or indicator endpoints.

Stocks

/stocks

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

string

The ticker symbol of an instrument for which data is requested

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

cik

string

The CIK of an instrument for which data is requested

Example: 95953

exchange

string

Filter by exchange name

Example: NASDAQ

mic_code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: XNGS

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

type

string

The 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

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

show_plan

boolean

Adds info on which plan symbol is available

Default: false

include_delisted

boolean

Include delisted identifiers

Default: false

page

integer

Page number of the results to fetch

Default: 1

outputsize

integer

Determines the number of data points returned in the output

Request example

Response

{
    "count": 100,
    "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",
                "plan_business": "Basic"
            }
        }
    ],
    "status": "ok"
}

Forex pairs

/forex_pairs

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

string

The ticker symbol of an instrument for which data is requested

Example: EUR/USD

currency_base

string

Filter by currency base

Example: EUR

currency_quote

string

Filter by currency quote

Example: USD

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

page

integer

Page number of the results to fetch

Default: 1

outputsize

integer

Determines the number of data points returned in the output

Request example

Response

{
    "count": 100,
    "data": [
        {
            "symbol": "EUR/USD",
            "currency_group": "Major",
            "currency_base": "EUR",
            "currency_quote": "USD"
        }
    ],
    "status": "ok"
}

Cryptocurrency pairs

/cryptocurrencies

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

string

The ticker symbol of an instrument for which data is requested

Example: BTC/USD

exchange

string

Filter by exchange name. E.g. Binance, Coinbase, etc.

Example: Binance

currency_base

string

Filter by currency base

Example: BTC

currency_quote

string

Filter by currency quote

Example: USD

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

page

integer

Page number of the results to fetch

Default: 1

outputsize

integer

Determines the number of data points returned in the output

Request example

Response

{
    "count": 100,
    "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"
}

ETFs

/etfs

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

string

The ticker symbol of an instrument for which data is requested

Example: SPY

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BDTF76

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

cik

string

The CIK of an instrument for which data is requested

Example: 95953

exchange

string

Filter by exchange name

Example: NYSE

mic_code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: XNYS

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

show_plan

boolean

Adds info on which plan symbol is available

Default: false

include_delisted

boolean

Include delisted identifiers

Default: false

page

integer

Page number of the results to fetch

Default: 1

outputsize

integer

Determines the number of data points returned in the output

Request example

Response

{
    "count": 100,
    "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",
                "plan_business": "Basic"
            }
        }
    ],
    "status": "ok"
}

Funds

/funds

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

string

The ticker symbol of an instrument for which data is requested

Example: FXAIX

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BHTMY7

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

cik

string

The CIK of an instrument for which data is requested

Example: 95953

exchange

string

Filter by exchange name

Example: Nasdaq

mic_code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: ARCX

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

show_plan

boolean

Adds info on which plan symbol is available

Default: false

page

integer

Page number of the results to fetch

Default: 1

outputsize

integer

Determines 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",
                    "plan_business": "Basic"
                }
            }
        ]
    },
    "status": "ok"
}

Commodities

/commodities

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

string

The ticker symbol of an instrument for which data is requested

Example: XAU/USD

category

string

Filter by category of commodity

Example: Precious Metal

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

page

integer

Page number of the results to fetch

Default: 1

outputsize

integer

Determines the number of data points returned in the output

Request example

Response

{
    "count": 100,
    "data": [
        {
            "category": "Energy Resource",
            "description": "Spot price per barrel of West Texas Intermediate crude oil.",
            "name": "Crude Oil WTI Spot",
            "symbol": "WTI/USD"
        },
        {
            "category": "Industrial Metal",
            "description": "Spot price per pound of copper.",
            "name": "Copper Spot",
            "symbol": "HG1"
        },
        {
            "category": "Precious Metal",
            "description": "Spot price per troy ounce of gold.",
            "name": "Gold Spot",
            "symbol": "XAU/USD"
        }
    ],
    "status": "ok"
}

Fixed income

/bonds

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

string

The ticker symbol of an instrument for which data is requested

Example: US2Y

exchange

string

Filter by exchange name

Example: NYSE

mic_code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: XNYS

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

show_plan

boolean

Adds info on which plan symbol is available

Default: false

page

integer

Page number of the results to fetch

Default: 1

outputsize

integer

Determines 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",
                    "plan_business": "Basic"
                }
            }
        ]
    },
    "status": "ok"
}

Discovery

Discovery endpoints help you find instruments when you don't already know the exact identifier. The Asset Catalog is the phone book; Discovery is the search engine on top of it.

Symbol search High demand

/symbol_search

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

string

Symbol to search. Supports:

  • Ticker symbol of instrument.
  • International securities identification number (ISIN). ISIN access is activating in the Data add-ons section
  • The FIGI (Financial Instrument Global Identifier) parameter is available on the Ultra plan (individual) and Enterprise plan (business) and above.
  • Composite FIGI parameter is available on the Ultra plan (individual) and Enterprise plan (business) and above.
  • Share Class FIGI parameter is available on the Ultra plan (individual) and Enterprise plan (business) and above.

Example: AAPL

outputsize

integer

Number of matches in response. Max 120

Default: 30

show_plan

boolean

Adds 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",
                "plan_business": "Basic"
            }
        }
    ],
    "status": "ok"
}

Cross listings

/cross_listings

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

This API endpoint is available on the Grow plan (individual) and the Venture plan (business) and above.

symbol

string

The ticker symbol of an instrument for which data is requested

Example: AAPL

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market identifier code (MIC) under ISO 10383 standard

Example: XNGS

country

string

Country 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"
            }
        ]
    }
}

Earliest timestamp

/earliest_timestamp

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

One of these parameters is required

symbol

string

Symbol ticker of the instrument.

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9XRY4

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

interval

string

Interval between two consecutive points in time series.

Supports: 1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 8h, 1day, 1week, 1month

Example: 1day

exchange

string

Exchange where instrument is traded.

Example: Nasdaq

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard.

Example: XNAS

timezone

string

Timezone at which output datetime will be displayed. Supports:

  • 1. Exchange for local exchange time
  • 2. UTC for datetime at universal UTC standard
  • 3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here.

Interval Limitation: The timezone parameter is only applicable for intraday intervals (less than 1 day). For intervals of 1day, 1week, or 1month, the timezone parameter is ignored, and data is strictly returned in the Exchange local time.

Take note that the IANA Timezone name is case-sensitive

Default: Exchange

Request example

Response

{
    "datetime": "1980-12-12",
    "unix_time": 345479400
}

Markets

Market endpoints answer operational questions about exchanges themselves: which ones are open right now, what are their trading hours, and how far back does data go for a given instrument?

Exchanges High demand

/exchanges

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

string

The 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

string

Filter by exchange name

Example: NASDAQ

code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: XBUE

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

show_plan

boolean

Adds 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",
                "plan_business": "Basic"
            }
        }
    ],
    "status": "ok"
}

Exchanges schedule

/exchange_schedule

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

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

date

string

If 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:

  • An exact date (e.g., 2021-10-27)
  • A human-readable keyword: today or yesterday
  • A full datetime string in UTC (e.g., 2025-04-11T20:00:00) to retrieve the schedule corresponding to the day in the specified time.

When using a datetime value, the resulting schedule will correspond to the local calendar day at the specified time. For example, 2025-04-11T20:00:00 UTC corresponds to:

  • 2025-04-11 in the America/New_York timezone
  • 2025-04-12 in the Australia/Sydney timezone

Example: 2021-10-27

mic_name

string

Filter by exchange name

Example: NASDAQ

mic_code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: XNGS

country

string

Filter 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"
                }
            ]
        }
    ]
}

Cryptocurrency exchanges

/cryptocurrency_exchanges

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

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

Specify the delimiter used when downloading the CSV file

Default: ;

Request example

Response

{
    "data": [
        {
            "name": "Binance"
        },
        {
            "name": "Coinbase Pro"
        },
        {
            "name": "Kraken"
        },
        {
            "name": "OKX"
        }
    ],
    "status": "ok"
}

Market state

/market_state

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

string

The exchange name where the instrument is traded.

Example: NYSE

code

string

The Market Identifier Code (MIC) of the exchange where the instrument is traded.

Example: XNYS

country

string

The 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"
    }
]

Supporting metadata

Metadata endpoints return the lookup tables and enumerations that define valid parameter values across the entire API. They answer: what instrument types exist? What intervals are supported? Which countries are covered? What technical indicators can I use?

Countries

/countries

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

No parameters are required

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"
        }
    ]
}

Instrument type

/instrument_type

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

No parameters are required

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"
}

Technical indicators

/technical_indicators

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

No parameters are required

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"
}

Fundamentals

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.

Logo

/logo

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

string

The ticker symbol of an instrument for which data is requested, e.g., AAPL, BTC/USD, EUR/USD.

Example: BTC/USD

exchange

string

The exchange name where the instrument is traded, e.g., NASDAQ, NSE

Example: NASDAQ

mic_code

string

The Market Identifier Code (MIC) of the exchange where the instrument is traded, e.g., XNAS, XLON

Example: XNAS

country

string

The 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"
}

Profile Useful

/profile

The profile endpoint provides detailed company information, including the company's name, industry, sector, CEO, and headquarters location. This data is useful for obtaining a comprehensive overview of a company's business and financial standing.

API credits cost

10 per symbol

This API endpoint is available on the Grow plan (individual) and the Venture plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country 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"
}

Dividends

/dividends

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 ex-date, amount, and frequency. This endpoint is ideal for users tracking dividend histories or evaluating the income potential of stocks.

API credits cost

20 per symbol

This API endpoint is available on the Grow plan (individual) and the Venture plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: US

range

string

Specifies 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

string

Start 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

string

End date for the dividend data query. Only dividends with dates on or before this date will be returned. Format 2006-01-02. If provided together with range parameter, range will take precedence.

Example: 2024-12-31

adjust

boolean

Specifies 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
        }
    ]
}

Dividends calendar

/dividends_calendar

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 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

This API endpoint is available on the Grow plan (individual) and the Venture plan (business) and above.

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: US

start_date

string

Start 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

string

End 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

integer

Number 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

integer

Page number

Default: 1

Request example

Response

[
    {
        "symbol": "MSFT",
        "mic_code": "XNGS",
        "exchange": "NASDAQ",
        "ex_date": "2024-02-14",
        "amount": 0.75
    }
]

Splits

/splits

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

This API endpoint is available on the Grow plan (individual) and the Venture plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

range

string

Range of data to be returned

Supports: last, 1m, 3m, 6m, ytd, 1y, 2y, 5y, full

Default: last

start_date

string

The starting date for data selection. Format 2006-01-02

Example: 2020-01-01

end_date

string

The 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
        }
    ]
}

Splits calendar

/splits_calendar

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

This API endpoint is available on the Grow plan (individual) and the Venture plan (business) and above.

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

start_date

string

The starting date (inclusive) for filtering split events in the calendar. Format 2006-01-02

Example: 2024-01-01

end_date

string

The ending date (inclusive) for filtering split events in the calendar. Format 2006-01-02

Example: 2024-12-31

outputsize

integer

Number 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

string

Page 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
    }
]

Earnings

/earnings

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

This API endpoint is available on the Grow plan (individual) and the Venture plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

type

string

The 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

string

Type of earning, returns only 1 record. When is not empty, dates and outputsize parameters are ignored

Supports: latest, next

outputsize

integer

Number 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

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

dp

integer

The number of decimal places in the response data. Should be in range [0,11] inclusive

Default: 2

start_date

string

The date from which the data is requested. The date format is YYYY-MM-DD.

Example: 2024-04-01

end_date

string

The 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"
}

Earnings calendar

/earnings_calendar

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

This API endpoint is available on the Grow plan (individual) and the Venture plan (business) and above.

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

format

string

Value can be JSON or CSV

Supports: JSON, CSV

Default: JSON

delimiter

string

Specify the delimiter used when downloading the CSV file

Default: ;

dp

integer

Specifies the number of decimal places for floating values. Should be in range [0,11] inclusive

Default: 2

start_date

string

Can be used separately and together with end_date. Format 2006-01-02 or 2006-01-02T15:04:05

Example: 2024-04-01

end_date

string

Can 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"
}

IPO calendar

/ipo_calendar

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

This API endpoint is available on the Grow plan (individual) and the Venture plan (business) and above.

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

start_date

string

The earliest IPO date to include in the results. Format: 2006-01-02

Example: 2021-01-01

end_date

string

The 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
        }
    ]
}

Statistics High demand

/statistics

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

This API endpoint is available on the Pro plan (individual) and the Venture plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country 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"
        }
    }
}

Press releases New

/press_releases

The press releases endpoint offers structured, real-time access to official company press releases and corporate announcements from public entities across global markets.

API credits cost

1 per request

This API endpoint is available on the Basic plan (individual) and above.

One of these parameters is required

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

start_date

string

Begin date for filtering items. Returns press releases with release date on or after this date. Format 2025-12-24T02:07:00

Example: 2025-12-01T00:00:00

end_date

string

End date for filtering items. Returns press releases with release date on or before this date. Format 2025-12-24T02:07:00

Example: 2025-12-31T23:59:00

language

string

Comma-separated list of languages to filter press releases by language.

Example: en,en-US

timezone

string

Time zone for date filtering. Default is the identifier time zone.

Example: America/New_York

outputsize

integer

Number of press releases returned per page. Default is 2, maximum is 10.

type: number

Default: 2

page

integer

Page number to return, starting at 1. Use it together with outputsize to walk the result set.

type: number

Default: 1

Request example

Response

{
    "press_releases": [
        {
            "id": "20251201SF35699",
            "datetime": "2021-11-12T11:21:00+01:00",
            "title": "NVIDIA and Synopsys Announce Strategic Partnership to Revolutionize Engineering and Design",
            "body": "<b>Key Highlights</b><ul><li>Multi-year collaboration spans NVIDIA CUDA accelerated computing, agentic and physical AI, and Omniverse digital twins to achieve simulation speed and scale previously unattainable through traditional CPU computing \u2013 opening new market opportunities across engineering.</li><li>To further adoption of GPU-accelerated engineering solutions, the companies will collaborate in engineering and marketing activities.</li><li>NVIDIA invested $2 billion in Synopsys common stock.</li></ul>...",
            "style": "/* Style Definitions */ ...",
            "language": [
                "en",
                "en-US"
            ]
        }
    ],
    "status": "ok",
    "pagination": {
        "current_page": 1,
        "per_page": 10
    }
}

Income statement High demand

/income_statement

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

This API endpoint is available on the Pro plan (individual) and the Venture plan (business) and above. Full access to historical data requires the Ultra plan (individual) or the Enterprise plan (business).

One of these parameters is required

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

period

string

The reporting period for the income statement data

Supports: annual, quarterly

Example: annual

start_date

string

Begin 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

string

End 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

integer

Number 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
        }
    ]
}

Income statement consolidated

/income_statement/consolidated

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

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

period

string

The reporting period for the income statement data

Supports: annual, quarterly

start_date

string

Begin 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

string

End 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

integer

Number of records in response

Default: 6

Request example

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"
}

Balance sheet High demand

/balance_sheet

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

This API endpoint is available on the Pro plan (individual) and the Venture plan (business) and above. Full access to historical data requires the Ultra plan (individual) or the Enterprise plan (business).

One of these parameters is required

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

period

string

The reporting period for the balance sheet data

Supports: annual, quarterly

Default: annual

start_date

string

Begin date for filtering items by fiscal date. Returns income statements with fiscal dates on or after this date. Format 2006-01-02

Example: 2024-01-01

end_date

string

End date for filtering items by fiscal date. Returns income statements with fiscal dates on or before this date. Format 2006-01-02

Example: 2024-05-01

outputsize

integer

Number 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"
    },
    "balance_sheet": [
        {
            "fiscal_date": "2021-09-30",
            "year": 2022,
            "assets": {
                "current_assets": {
                    "cash": 17305000000,
                    "cash_equivalents": 17635000000,
                    "cash_and_cash_equivalents": 34940000000,
                    "other_short_term_investments": 27699000000,
                    "accounts_receivable": 26278000000,
                    "other_receivables": 25228000000,
                    "inventory": 6580000000,
                    "prepaid_assets": 0,
                    "restricted_cash": 0,
                    "assets_held_for_sale": 0,
                    "hedging_assets": 0,
                    "other_current_assets": 14111000000,
                    "total_current_assets": 134836000000
                },
                "non_current_assets": {
                    "properties": 0,
                    "land_and_improvements": 20041000000,
                    "machinery_furniture_equipment": 78659000000,
                    "construction_in_progress": 0,
                    "leases": 11023000000,
                    "accumulated_depreciation": -70283000000,
                    "goodwill": 0,
                    "investment_properties": 0,
                    "financial_assets": 0,
                    "intangible_assets": 0,
                    "investments_and_advances": 127877000000,
                    "other_non_current_assets": 48849000000,
                    "total_non_current_assets": 216166000000
                },
                "total_assets": 351002000000
            },
            "liabilities": {
                "current_liabilities": {
                    "accounts_payable": 54763000000,
                    "accrued_expenses": 0,
                    "short_term_debt": 15613000000,
                    "deferred_revenue": 7612000000,
                    "tax_payable": 0,
                    "pensions": 0,
                    "other_current_liabilities": 47493000000,
                    "total_current_liabilities": 125481000000
                },
                "non_current_liabilities": {
                    "long_term_provisions": 0,
                    "long_term_debt": 109106000000,
                    "provision_for_risks_and_charges": 24689000000,
                    "deferred_liabilities": 0,
                    "derivative_product_liabilities": 0,
                    "other_non_current_liabilities": 28636000000,
                    "total_non_current_liabilities": 162431000000
                },
                "total_liabilities": 287912000000
            },
            "shareholders_equity": {
                "common_stock": 57365000000,
                "retained_earnings": 5562000000,
                "other_shareholders_equity": 163000000,
                "total_shareholders_equity": 63090000000,
                "additional_paid_in_capital": 0,
                "treasury_stock": 0,
                "minority_interest": 0
            }
        }
    ]
}

Balance sheet consolidated

/balance_sheet/consolidated

The balance sheet consolidated endpoint provides a detailed overview of a company's raw balance sheet, including a comprehensive summary of its assets, liabilities, and shareholders' equity. This endpoint is useful for retrieving financial data that reflects the overall financial position of a company, allowing users to access critical information about its financial health and structure.

API credits cost

100 per symbol

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

period

string

The reporting period for the balance sheet data.

Supports: annual, quarterly

Default: annual

start_date

string

Begin date for filtering items by fiscal date. Returns income statements with fiscal dates on or after this date. Format 2006-01-02

end_date

string

End date for filtering items by fiscal date. Returns income statements with fiscal dates on or before this date. Format 2006-01-02

outputsize

integer

Number of records in response

Default: 6

Request example

Response

{
    "balance_sheet": [
        {
            "fiscal_date": "2023-09-30",
            "assets": {
                "total_assets": 352583000000,
                "current_assets": {
                    "total_current_assets": 143566000000,
                    "cash_cash_equivalents_and_short_term_investments": 61555000000,
                    "cash_and_cash_equivalents": 29965000000,
                    "cash_equivalents": 1606000000,
                    "cash_financial": 28359000000,
                    "other_short_term_investments": 31590000000,
                    "restricted_cash": 31590000000,
                    "receivables": {
                        "total_receivables": 60985000000,
                        "accounts_receivable": 29508000000,
                        "gross_accounts_receivable": 29508000000,
                        "allowance_for_doubtful_accounts_receivable": 29508000000,
                        "receivables_adjustments_allowances": 29508000000,
                        "other_receivables": 31477000000,
                        "due_from_related_parties_current": 31477000000,
                        "taxes_receivable": 31477000000,
                        "accrued_interest_receivable": 31477000000,
                        "notes_receivable": 31477000000,
                        "loans_receivable": 31477000000
                    },
                    "inventory": {
                        "total_inventory": 6331000000,
                        "inventories_adjustments_allowances": 6331000000,
                        "other_inventories": 6331000000,
                        "finished_goods": 6331000000,
                        "work_in_process": 6331000000,
                        "raw_materials": 6331000000
                    },
                    "prepaid_assets": 14695000000,
                    "current_deferred_assets": 14695000000,
                    "current_deferred_taxes_assets": 14695000000,
                    "assets_held_for_sale_current": 14695000000,
                    "hedging_assets_current": 14695000000,
                    "other_current_assets": 14695000000
                },
                "non_current_assets": {
                    "total_non_current_assets": 209017000000,
                    "financial_assets": 209017000000,
                    "investments_and_advances": 100544000000,
                    "other_investments": 100544000000,
                    "investment_in_financial_assets": 100544000000,
                    "held_to_maturity_securities": 100544000000,
                    "available_for_sale_securities": 100544000000,
                    "financial_assets_designated_as_fair_value_through_profit_or_loss_total": 100544000000,
                    "trading_securities": 100544000000,
                    "long_term_equity_investment": 100544000000,
                    "investments_in_joint_ventures_at_cost": 100544000000,
                    "investments_in_other_ventures_under_equity_method": 100544000000,
                    "investments_in_associates_at_cost": 100544000000,
                    "investments_in_subsidiaries_at_cost": 100544000000,
                    "investment_properties": 100544000000,
                    "goodwill_and_other_intangible_assets": {
                        "goodwill": 100544000000,
                        "other_intangible_assets": 100544000000,
                        "total_goodwill_and_intangible_assets": 100544000000
                    },
                    "net_ppe": 54376000000,
                    "gross_ppe": 125260000000,
                    "accumulated_depreciation": -70884000000,
                    "leases": 12839000000,
                    "construction_in_progress": 12839000000,
                    "other_properties": 10661000000,
                    "machinery_furniture_equipment": 78314000000,
                    "buildings_and_improvements": 12839000000,
                    "land_and_improvements": 23446000000,
                    "properties": 0,
                    "non_current_accounts_receivable": 12839000000,
                    "non_current_note_receivables": 12839000000,
                    "due_from_related_parties_non_current": 12839000000,
                    "non_current_prepaid_assets": 12839000000,
                    "non_current_deferred_assets": 17852000000,
                    "non_current_deferred_taxes_assets": 17852000000,
                    "defined_pension_benefit": 12839000000,
                    "other_non_current_assets": 36245000000
                },
                "liabilities": {
                    "total_liabilities_net_minority_interest": 290437000000,
                    "current_liabilities": {
                        "total_current_liabilities": 145308000000,
                        "current_debt_and_capital_lease_obligation": 17382000000,
                        "current_debt": 15807000000,
                        "current_capital_lease_obligation": 1575000000,
                        "other_current_borrowings": 9822000000,
                        "line_of_credit": 9822000000,
                        "commercial_paper": 5985000000,
                        "current_notes_payable": 9822000000,
                        "current_provisions": 9822000000,
                        "payables_and_accrued_expenses": {
                            "total_payables_and_accrued_expenses": 71430000000,
                            "accounts_payable": 62611000000,
                            "current_accrued_expenses": 9822000000,
                            "interest_payable": 9822000000,
                            "payables": 71430000000,
                            "other_payable": 9822000000,
                            "due_to_related_parties_current": 9822000000,
                            "dividends_payable": 9822000000,
                            "total_tax_payable": 8819000000,
                            "income_tax_payable": 8819000000
                        },
                        "pension_and_other_post_retirement_benefit_plans_current": 8061000000,
                        "employee_benefits": 8061000000,
                        "current_deferred_liabilities": 8061000000,
                        "current_deferred_revenue": 8061000000,
                        "current_deferred_taxes_liabilities": 8061000000,
                        "other_current_liabilities": 48435000000,
                        "liabilities_held_for_sale_non_current": 48435000000
                    },
                    "non_current_liabilities": {
                        "total_non_current_liabilities_net_minority_interest": 145129000000,
                        "long_term_debt_and_capital_lease_obligation": {
                            "total_long_term_debt_and_capital_lease_obligation": 106548000000,
                            "long_term_debt": 95281000000,
                            "long_term_capital_lease_obligation": 11267000000
                        },
                        "long_term_provisions": 15457000000,
                        "non_current_pension_and_other_postretirement_benefit_plans": 15457000000,
                        "non_current_accrued_expenses": 15457000000,
                        "due_to_related_parties_non_current": 15457000000,
                        "trade_and_other_payables_non_current": 15457000000,
                        "non_current_deferred_liabilities": 15457000000,
                        "non_current_deferred_revenue": 15457000000,
                        "non_current_deferred_taxes_liabilities": 15457000000,
                        "other_non_current_liabilities": 23124000000,
                        "preferred_securities_outside_stock_equity": 15457000000,
                        "derivative_product_liabilities": 15457000000,
                        "capital_lease_obligations": 12842000000,
                        "restricted_common_stock": 12842000000
                    },
                    "equity": {
                        "total_equity_gross_minority_interest": 62146000000,
                        "stockholders_equity": 62146000000,
                        "common_stock_equity": 62146000000,
                        "preferred_stock_equity": 62146000000,
                        "other_equity_interest": 62146000000,
                        "minority_interest": 62146000000,
                        "total_capitalization": 157427000000,
                        "net_tangible_assets": 62146000000,
                        "tangible_book_value": 62146000000,
                        "invested_capital": 173234000000,
                        "working_capital": -1742000000,
                        "capital_stock": {
                            "common_stock": 73812000000,
                            "preferred_stock": 73812000000,
                            "total_partnership_capital": 73812000000,
                            "general_partnership_capital": 73812000000,
                            "limited_partnership_capital": 73812000000,
                            "capital_stock": 73812000000,
                            "other_capital_stock": 73812000000,
                            "additional_paid_in_capital": 73812000000,
                            "retained_earnings": -214000000,
                            "treasury_stock": 73812000000,
                            "treasury_shares_number": 0,
                            "ordinary_shares_number": 15550061000,
                            "preferred_shares_number": 73812000000,
                            "share_issued": 15550061000
                        },
                        "equity_adjustments": {
                            "gains_losses_not_affecting_retained_earnings": -11452000000,
                            "other_equity_adjustments": -11452000000,
                            "fixed_assets_revaluation_reserve": 11452000000,
                            "foreign_currency_translation_adjustments": 11452000000,
                            "minimum_pension_liabilities": 11452000000,
                            "unrealized_gain_loss": 11452000000
                        },
                        "net_debt": 81123000000,
                        "total_debt": 123930000000
                    }
                }
            }
        }
    ],
    "status": "ok"
}

Cash flow High demand

/cash_flow

The cash flow endpoint provides detailed information on a company's cash flow activities, including the net cash and cash equivalents moving in and out of the business. This data includes operating, investing, and financing cash flows, offering a comprehensive view of the company's liquidity and financial health.

API credits cost

100 per symbol

This API endpoint is available on the Pro plan (individual) and the Venture plan (business) and above. Full access to historical data requires the Ultra plan (individual) or the Enterprise plan (business).

One of these parameters is required

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

period

string

The reporting period for the cash flow statements

Supports: annual, quarterly

Default: annual

start_date

string

Start date for filtering cash flow statements. Only cash flow statements with fiscal dates on or after this date will be included. Format 2006-01-02

Example: 2024-01-01

end_date

string

End date for filtering cash flow statements. Only cash flow statements with fiscal dates on or before this date will be included. Format 2006-01-02

Example: 2024-12-31

outputsize

integer

Number 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"
    },
    "cash_flow": [
        {
            "fiscal_date": "2021-12-31",
            "quarter": "1",
            "year": 2022,
            "operating_activities": {
                "net_income": 34630000000,
                "depreciation": 2697000000,
                "deferred_taxes": 682000000,
                "stock_based_compensation": 2265000000,
                "other_non_cash_items": 167000000,
                "accounts_receivable": -13746000000,
                "accounts_payable": 19813000000,
                "other_assets_liabilities": 458000000,
                "operating_cash_flow": 46966000000
            },
            "investing_activities": {
                "capital_expenditures": -2803000000,
                "net_intangibles": 0,
                "net_acquisitions": 0,
                "purchase_of_investments": -34913000000,
                "sale_of_investments": 21984000000,
                "other_investing_activity": -374000000,
                "investing_cash_flow": -16106000000
            },
            "financing_activities": {
                "long_term_debt_issuance": 0,
                "long_term_debt_payments": 0,
                "short_term_debt_issuance": -1000000000,
                "common_stock_issuance": 0,
                "common_stock_repurchase": -20478000000,
                "common_dividends": -3732000000,
                "other_financing_charges": -2949000000,
                "financing_cash_flow": -28159000000
            },
            "end_cash_position": 38630000000,
            "income_tax_paid": 5235000000,
            "interest_paid": 531000000,
            "free_cash_flow": 49769000000
        }
    ]
}

Cash flow consolidated

/cash_flow/consolidated

The cash flow consolidated endpoint provides raw data on a company's consolidated cash flow, including the net cash and cash equivalents moving in and out of the business. It returns information on operating, investing, and financing activities, helping users track liquidity and financial health over a specified period.

API credits cost

100 per symbol

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country where instrument is traded, e.g., United States or US

Example: United States

period

string

The reporting period for the cash flow statements

Supports: annual, quarterly

Default: annual

start_date

string

Start date for filtering cash flow statements. Only cash flow statements with fiscal dates on or after this date will be included. Format 2006-01-02

Example: 2024-01-01

end_date

string

End date for filtering cash flow statements. Only cash flow statements with fiscal dates on or before this date will be included. Format 2006-01-02

Example: 2024-12-31

outputsize

integer

Number of records in response

Default: 6

Request example

Response

{
    "cash_flow": [
        {
            "fiscal_date": "2023-09-30",
            "year": 2024,
            "cash_flow_from_operating_activities": {
                "net_income_from_continuing_operations": 96995000000,
                "operating_cash_flow": 110543000000,
                "cash_flow_from_continuing_operating_activities": 110543000000,
                "cash_from_discontinued_operating_activities": 108488000000,
                "cash_flow_from_discontinued_operation": 108488000000,
                "free_cash_flow": 99584000000,
                "cash_flows_from_used_in_operating_activities_direct": 108488000000,
                "taxes_refund_paid": 108488000000,
                "taxes_refund_paid_direct": 108488000000,
                "interest_received": 108488000000,
                "interest_received_direct": 108488000000,
                "interest_paid": 108488000000,
                "interest_paid_direct": 108488000000,
                "dividend_received": 108488000000,
                "dividend_received_direct": 108488000000,
                "dividend_paid": 108488000000,
                "dividend_paid_direct": 108488000000,
                "change_in_working_capital": -6577000000,
                "change_in_other_working_capital": 108488000000,
                "change_in_receivables": -417000000,
                "changes_in_account_receivables": -1688000000,
                "change_in_payables_and_accrued_expense": -1889000000,
                "change_in_accrued_expense": 108488000000,
                "change_in_payable": -1889000000,
                "change_in_dividend_payable": 108488000000,
                "change_in_account_payable": -1889000000,
                "change_in_tax_payable": 108488000000,
                "change_in_income_tax_payable": 108488000000,
                "change_in_interest_payable": 108488000000,
                "change_in_other_current_liabilities": 3031000000,
                "change_in_other_current_assets": -5684000000,
                "change_in_inventory": -1618000000,
                "change_in_prepaid_assets": 108488000000,
                "other_non_cash_items": -2227000000,
                "excess_tax_benefit_from_stock_based_compensation": 108488000000,
                "stock_based_compensation": 10833000000,
                "unrealized_gain_loss_on_investment_securities": 108488000000,
                "provision_and_write_off_of_assets": 108488000000,
                "asset_impairment_charge": 108488000000,
                "amortization_of_securities": 108488000000,
                "deferred_tax": 108488000000,
                "deferred_income_tax": 108488000000,
                "depreciation_amortization_depletion": 11519000000,
                "depletion": 108488000000,
                "depreciation_and_amortization": 11519000000,
                "amortization_cash_flow": 108488000000,
                "amortization_of_intangibles": 108488000000,
                "depreciation": 108488000000,
                "operating_gains_losses": 108488000000,
                "pension_and_employee_benefit_expense": 108488000000,
                "earnings_losses_from_equity_investments": 108488000000,
                "gain_loss_on_investment_securities": 108488000000,
                "net_foreign_currency_exchange_gain_loss": 108488000000,
                "gain_loss_on_sale_of_ppe": 108488000000,
                "gain_loss_on_sale_of_business": 108488000000
            },
            "cash_flow_from_investing_activities": {
                "investing_cash_flow": 3705000000,
                "cash_flow_from_continuing_investing_activities": 3705000000,
                "cash_from_discontinued_investing_activities": 108488000000,
                "net_other_investing_changes": -1337000000,
                "interest_received_cfi": 108488000000,
                "dividends_received_cfi": 108488000000,
                "net_investment_purchase_and_sale": 16001000000,
                "sale_of_investment": 45514000000,
                "purchase_of_investment": -29513000000,
                "net_investment_properties_purchase_and_sale": 108488000000,
                "sale_of_investment_properties": 108488000000,
                "purchase_of_investment_properties": 108488000000,
                "net_business_purchase_and_sale": 108488000000,
                "sale_of_business": 108488000000,
                "purchase_of_business": 108488000000,
                "net_intangibles_purchase_and_sale": 108488000000,
                "sale_of_intangibles": 108488000000,
                "purchase_of_intangibles": 108488000000,
                "net_ppe_purchase_and_sale": -10959000000,
                "sale_of_ppe": 108488000000,
                "purchase_of_ppe": -10959000000,
                "capital_expenditure_reported": 108488000000,
                "capital_expenditure": -10959000000
            },
            "cash_flow_from_financing_activities": {
                "financing_cash_flow": -108488000000,
                "cash_flow_from_continuing_financing_activities": -108488000000,
                "cash_from_discontinued_financing_activities": 108488000000,
                "net_other_financing_charges": -6012000000,
                "interest_paid_cff": 108488000000,
                "proceeds_from_stock_option_exercised": 108488000000,
                "cash_dividends_paid": -15025000000,
                "preferred_stock_dividend_paid": 108488000000,
                "common_stock_dividend_paid": -15025000000,
                "net_preferred_stock_issuance": 108488000000,
                "preferred_stock_payments": 108488000000,
                "preferred_stock_issuance": 108488000000,
                "net_common_stock_issuance": -77550000000,
                "common_stock_payments": -77550000000,
                "common_stock_issuance": 108488000000,
                "repurchase_of_capital_stock": -77550000000,
                "net_issuance_payments_of_debt": -9901000000,
                "net_short_term_debt_issuance": -3978000000,
                "short_term_debt_payments": 108488000000,
                "short_term_debt_issuance": 108488000000,
                "net_long_term_debt_issuance": -5923000000,
                "long_term_debt_payments": -11151000000,
                "long_term_debt_issuance": 5228000000,
                "issuance_of_debt": 5228000000,
                "repayment_of_debt": -11151000000,
                "issuance_of_capital_stock": 108488000000
            },
            "supplemental_data": {
                "interest_paid_supplemental_data": 3803000000,
                "income_tax_paid_supplemental_data": 18679000000
            },
            "foreign_and_domestic_sales": {
                "foreign_sales": 108488000000,
                "domestic_sales": 108488000000,
                "adjusted_geography_segment_data": 108488000000
            },
            "cash_position": {
                "beginning_cash_position": 24977000000,
                "end_cash_position": 30737000000,
                "changes_in_cash": 5760000000,
                "other_cash_adjustment_outside_change_in_cash": 108488000000,
                "other_cash_adjustment_inside_change_in_cash": 108488000000,
                "effect_of_exchange_rate_changes": 108488000000
            },
            "direct_method_cash_flow": {
                "classes_of_cash_receipts_from_operating_activities": 108488000000,
                "other_cash_receipts_from_operating_activities": 108488000000,
                "receipts_from_government_grants": 108488000000,
                "receipts_from_customers": 108488000000,
                "classes_of_cash_payments": 108488000000,
                "other_cash_payments_from_operating_activities": 108488000000,
                "payments_on_behalf_of_employees": 108488000000,
                "payments_to_suppliers_for_goods_and_services": 108488000000
            }
        }
    ],
    "status": "ok"
}

Key executives Useful

/key_executives

The key executives endpoint provides detailed information about a company's key executives identified by a specific stock symbol. It returns data such as names, titles, and roles of the executives, which can be useful for understanding the leadership structure of the company.

API credits cost

1000 per symbol

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Exchange where instrument is traded

Example: NASDAQ

mic_code

string

Market Identifier Code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Country 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"
    },
    "key_executives": [
        {
            "name": "Mr. Timothy D. Cook",
            "title": "CEO & Director",
            "age": 59,
            "year_born": 1961,
            "pay": 14769259
        }
    ]
}

Market capitalization New

/market_cap

The Market Capitalization History endpoint provides historical data on a company's market capitalization over a specified time period. It returns a time series of market cap values, allowing users to track changes in a company's market value.

API credits cost

5 per request

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

One of these parameters is required

symbol

string

Filter by symbol

Example: AAPL

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000B9Y5X2

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US0378331005

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 594918104

exchange

string

Filter by exchange name

Example: NASDAQ

mic_code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

start_date

string

Start date for market capitalization data retrieval. Data will be returned from this date onwards. Format 2006-01-02

Example: 2023-01-01

end_date

string

End date for market capitalization data retrieval. Data will be returned up to and including this date. Format 2006-01-02

Example: 2023-12-31

page

integer

Page number

Default: 1

outputsize

integer

Number of records in response

Default: 10

Request example

Response

{
    "meta": {
        "symbol": "AAPL",
        "name": "Apple Inc",
        "currency": "USD",
        "exchange": "NASDAQ",
        "mic_code": "XNAS",
        "exchange_timezone": "America/New_York"
    },
    "market_cap": [
        {
            "date": "2025-07-14",
            "value": 3115906555944
        },
        {
            "date": "2025-07-11",
            "value": 3153843487457
        },
        {
            "date": "2025-07-10",
            "value": 3172513237217
        }
    ]
}

Last changes New

/last_change/{endpoint}

The last change endpoint provides the most recent updates to fundamental data for a specified dataset. It returns a timestamp indicating when the data was last modified, allowing users to efficiently manage API requests by only fetching new data when changes occur. This helps optimize data retrieval and reduce unnecessary API credit usage.

API credits cost

1 per request

endpoint

string

Endpoint name

Supports: price_target, recommendations, statistics, insider_transactions, profile, mutual_funds_world_summary, mutual_funds_world, institutional_holders, analyst_rating, income_statement, income_statement_quarterly, cash_flow, cash_flow_quarterly, balance_sheet, balance_sheet_quarterly, mutual_funds_list, mutual_funds_world_sustainability, mutual_funds_world_summary, mutual_funds_world_risk, mutual_funds_world_purchase_info, mutual_funds_world_composition, mutual_funds_world_performance, mutual_funds_world, etfs_list, etfs_world, etfs_world_summary, etfs_world_performance, etfs_world_risk, etfs_world_composition, dividends, splits, money_market_funds_world

Example: statistics

start_date

string

The starting date and time for data selection, in 2006-01-02T15:04:05 format

Example: 2023-10-14T00:00:00

symbol

string

Filter by symbol

Example: AAPL

exchange

string

Filter by exchange name

Example: NASDAQ

mic_code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: XNAS

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

page

integer

Page number

Default: 1

outputsize

integer

Number of records in response

Default: 30

Request example

Response

{
    "pagination": {
        "current_page": 1,
        "per_page": 30
    },
    "data": [
        {
            "symbol": "AAPL",
            "mic_code": "XNAS",
            "last_change": "2023-10-14 12:22:48"
        }
    ]
}

Currencies

Exchange rate

/exchange_rate

The exchange rate endpoint provides real-time exchange rates for specified currency pairs, including both forex and cryptocurrency. It returns the current exchange rate value between two currencies, allowing users to quickly access up-to-date conversion rates for financial transactions or market analysis.

API credits cost

1 per symbol

symbol

string

The currency pair you want to request can be either forex or cryptocurrency. Slash(/) delimiter is used. E.g. EUR/USD or BTC/ETH will be correct

Example: EUR/USD

date

string

If not null, will use exchange rate from a specific date or time. Format 2006-01-02 or 2006-01-02T15:04:05. Is set in the local exchange time zone, use timezone parameter to specify a specific time zone

Example: 2006-01-02T15:04:05

format

string

Value can be JSON or CSV. Default JSON

Supports: JSON, CSV

Default: JSON

delimiter

string

Specify the delimiter used when downloading the CSV file. Default semicolon ;

Default: ;

dp

integer

The number of decimal places for the data

Default: 5

timezone

string

Timezone at which output datetime will be displayed. Supports:

  • 1. Exchange for local exchange time
  • 2. UTC for datetime at universal UTC standard
  • 3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here.

Take note that the IANA Timezone name is case-sensitive

Example: UTC

Request example

Response

{
    "symbol": "USD/JPY",
    "rate": 105.12,
    "timestamp": 1602714051
}

Currency conversion Useful

/currency_conversion

The currency conversion endpoint provides real-time exchange rates and calculates the converted amount for specified currency pairs, including both forex and cryptocurrencies. This endpoint is useful for obtaining up-to-date conversion values between two currencies, facilitating tasks such as financial reporting, e-commerce transactions, and travel budgeting.

API credits cost

1 per symbol

symbol

string

The currency pair you want to request can be either forex or cryptocurrency. Slash(/) delimiter is used. E.g. EUR/USD or BTC/ETH will be correct

Example: EUR/USD

amount

double

Amount of base currency to be converted into quote currency. Supports values in the range from 0 and above

Example: 100

date

string

If not null, will use exchange rate from a specific date or time. Format 2006-01-02 or 2006-01-02T15:04:05. Is set in the local exchange time zone, use timezone parameter to specify a specific time zone

Example: 2006-01-02T15:04:05

format

string

Value can be JSON or CSV. Default JSON

Supports: JSON, CSV

Default: JSON

delimiter

string

Specify the delimiter used when downloading the CSV file. Default semicolon ;

Default: ;

dp

integer

The number of decimal places for the data

Default: 5

timezone

string

Timezone at which output datetime will be displayed. Supports:

  • 1. Exchange for local exchange time
  • 2. UTC for datetime at universal UTC standard
  • 3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here.

Take note that the IANA Timezone name is case-sensitive

Example: UTC

Request example

Response

{
    "symbol": "USD/JPY",
    "rate": 105.12,
    "amount": 12824.64,
    "timestamp": 1602714051
}

ETFs

ETF-focused metadata and analytics: universe lists, family and type groupings, NAV snapshots, performance metrics, risk measures, and current fund composition. Tailored to the unique characteristics and reporting cadence of exchange-traded funds.

ETFs directory Useful

/etfs/list

The ETFs directory endpoint provides a daily updated list of exchange-traded funds, sorted by total assets in descending order. This endpoint is useful for retrieving comprehensive ETF data, including fund names and asset values, to assist users in quickly identifying the ETFs available.

API credits cost

1 per request

Basic, Grow, and Pro plans (individual) and Venture plan (business) return up to 50 records. For complete data on over 40,000 ETFs, upgrade to the Ultra plan (individual), Enterprise (business), or Custom plan (business).

symbol

string

Filter by symbol

Example: IVV

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BVZ697

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US4642872000

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 464287200

cik

string

The CIK of an instrument for which data is requested

Example: 95953

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

fund_family

string

Filter by investment company that manages the fund

Example: iShares

fund_type

string

Filter by the type of fund

Example: Large Blend

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

dp

integer

Number of decimal places for floating values

Default: 5

page

integer

Page number

Default: 1

outputsize

integer

Number of records in response

Default: 50

Request example

Response

{
    "result": {
        "count": 1000,
        "list": [
            {
                "symbol": "IVV",
                "name": "iShares Core S&P 500 ETF",
                "country": "United States",
                "mic_code": "XNAS",
                "fund_family": "iShares",
                "fund_type": "Large Blend"
            }
        ]
    },
    "status": "ok"
}

ETF full data High demand

/etfs/world

The ETF full data endpoint provides detailed information about global Exchange-Traded Funds. It returns comprehensive data, including a summary, performance metrics, risk assessment, and composition details. This endpoint is ideal for users seeking an in-depth analysis of worldwide ETFs, enabling them to access key financial metrics and portfolio breakdowns.

API credits cost

800 per request

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of etf

Example: IVV

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BVZ697

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US4642872000

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 464287200

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

dp

integer

Number of decimal places for floating values. Accepts value in range [0,11]

Default: 5

Request example

Response

{
    "etf": {
        "summary": {
            "symbol": "IVV",
            "name": "iShares Core S&P 500 ETF",
            "fund_family": "iShares",
            "fund_type": "Large Blend",
            "currency": "USD",
            "share_class_inception_date": "2000-11-13",
            "ytd_return": -0.0537,
            "expense_ratio_net": -0.004,
            "yield": 0.0133,
            "nav": 413.24,
            "last_price": 413.24,
            "turnover_rate": 0.04,
            "net_assets": 753409982464,
            "overview": "The investment seeks to track the performance of the Standard & Poor's 500..."
        },
        "performance": {
            "trailing_returns": [
                {
                    "period": "ytd",
                    "share_class_return": -0.0751,
                    "category_return": 0.1484
                }
            ],
            "annual_total_returns": [
                {
                    "year": 2021,
                    "share_class_return": 0.2866,
                    "category_return": 0
                }
            ]
        },
        "risk": {
            "volatility_measures": [
                {
                    "period": "3_year",
                    "alpha": -0.03,
                    "alpha_category": -0.02,
                    "beta": 1,
                    "beta_category": 0.01,
                    "mean_annual_return": 1.58,
                    "mean_annual_return_category": 0.01,
                    "r_squared": 100,
                    "r_squared_category": 0.95,
                    "std": 18.52,
                    "std_category": 0.19,
                    "sharpe_ratio": 0.95,
                    "sharpe_ratio_category": 0.01,
                    "treynor_ratio": 17.41,
                    "treynor_ratio_category": 0.16
                }
            ],
            "valuation_metrics": {
                "price_to_earnings": 26.46,
                "price_to_book": 4.42,
                "price_to_sales": 2.96,
                "price_to_cashflow": 17.57
            }
        },
        "composition": {
            "major_market_sectors": [
                {
                    "sector": "Technology",
                    "weight": 0.2424
                }
            ],
            "country_allocation": [
                {
                    "country": "United Kingdom",
                    "allocation": 0.9855
                }
            ],
            "asset_allocation": {
                "cash": 0.0004,
                "stocks": 0.9996,
                "preferred_stocks": 0,
                "convertables": 0,
                "bonds": 0,
                "others": 0
            },
            "top_holdings": [
                {
                    "symbol": "AAPL",
                    "name": "Apple Inc",
                    "exchange": "NASDAQ",
                    "mic_code": "XNAS",
                    "weight": 0.0592
                }
            ],
            "bond_breakdown": {
                "average_maturity": {
                    "fund": 6.65,
                    "category": 7.81
                },
                "average_duration": {
                    "fund": 5.72,
                    "category": 5.64
                },
                "credit_quality": [
                    {
                        "grade": "AAA",
                        "weight": 0
                    }
                ]
            }
        }
    },
    "status": "ok"
}

Summary

/etfs/world/summary

The ETFs summary endpoint provides a concise overview of global Exchange-Traded Funds. It returns key data points such as ETF names, symbols, and current market values, enabling users to quickly assess the performance and status of various international ETFs. This summary is ideal for users who need a snapshot of the global ETF landscape without delving into detailed analysis.

API credits cost

200 per request

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of etf

Example: IVV

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BVZ697

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US4642872000

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 464287200

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

dp

integer

Number of decimal places for floating values. Accepts value in range [0,11]

Default: 5

Request example

Response

{
    "etf": {
        "summary": {
            "symbol": "IVV",
            "name": "iShares Core S&P 500 ETF",
            "fund_family": "iShares",
            "fund_type": "Large Blend",
            "currency": "USD",
            "share_class_inception_date": "2000-11-13",
            "ytd_return": -0.0537,
            "expense_ratio_net": -0.004,
            "yield": 0.0133,
            "nav": 413.24,
            "last_price": 413.24,
            "turnover_rate": 0.04,
            "net_assets": 753409982464,
            "overview": "The investment seeks to track the performance of the Standard & Poor's 500..."
        }
    },
    "status": "ok"
}

Performance High demand

/etfs/world/performance

The ETFs performance endpoint provides comprehensive performance data for exchange-traded funds globally. It returns detailed metrics such as trailing returns and annual returns, enabling users to evaluate the historical performance of various ETFs. This endpoint is ideal for users looking to compare ETF performance over different time periods and assess their investment potential.

API credits cost

200 per request

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of etf

Example: IVV

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BVZ697

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US4642872000

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 464287200

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

dp

integer

Number of decimal places for floating values. Accepts value in range [0,11]

Default: 5

Request example

Response

{
    "etf": {
        "performance": {
            "trailing_returns": [
                {
                    "period": "ytd",
                    "share_class_return": -0.0751,
                    "category_return": 0.1484
                }
            ],
            "annual_total_returns": [
                {
                    "year": 2021,
                    "share_class_return": 0.2866,
                    "category_return": 0
                }
            ]
        }
    },
    "status": "ok"
}

Risk

/etfs/world/risk

The ETFs risk endpoint provides essential risk metrics for global Exchange Traded Funds. It returns data such as volatility, beta, and other risk-related indicators, enabling users to assess the potential risk associated with investing in various ETFs worldwide.

API credits cost

200 per request

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of etf

Example: IVV

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BVZ697

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US4642872000

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 464287200

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

dp

integer

Number of decimal places for floating values. Accepts value in range [0,11]

Default: 5

Request example

Response

{
    "etf": {
        "risk": {
            "volatility_measures": [
                {
                    "period": "3_year",
                    "alpha": -0.03,
                    "alpha_category": -0.02,
                    "beta": 1,
                    "beta_category": 0.01,
                    "mean_annual_return": 1.58,
                    "mean_annual_return_category": 0.01,
                    "r_squared": 100,
                    "r_squared_category": 0.95,
                    "std": 18.52,
                    "std_category": 0.19,
                    "sharpe_ratio": 0.95,
                    "sharpe_ratio_category": 0.01,
                    "treynor_ratio": 17.41,
                    "treynor_ratio_category": 0.16
                }
            ],
            "valuation_metrics": {
                "price_to_earnings": 26.46,
                "price_to_book": 4.42,
                "price_to_sales": 2.96,
                "price_to_cashflow": 17.57
            }
        }
    },
    "status": "ok"
}

Composition High demand

/etfs/world/composition

The ETFs composition endpoint provides detailed information about the composition of global Exchange-Traded Funds. It returns data on the sectors included in the ETF, specific holding details, and the weighted exposure of each component. This endpoint is useful for users who need to understand the specific makeup and sector distribution of an ETF portfolio.

API credits cost

200 per request

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of etf

Example: IVV

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG000BVZ697

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: US4642872000

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 464287200

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

dp

integer

Number of decimal places for floating values. Accepts value in range [0,11]

Default: 5

Request example

Response

{
    "etf": {
        "composition": {
            "major_market_sectors": [
                {
                    "sector": "Technology",
                    "weight": 0.2424
                }
            ],
            "country_allocation": [
                {
                    "country": "United Kingdom",
                    "allocation": 0.9855
                }
            ],
            "asset_allocation": {
                "cash": 0.0004,
                "stocks": 0.9996,
                "preferred_stocks": 0,
                "convertables": 0,
                "bonds": 0,
                "others": 0
            },
            "top_holdings": [
                {
                    "symbol": "AAPL",
                    "name": "Apple Inc",
                    "exchange": "NASDAQ",
                    "mic_code": "XNAS",
                    "weight": 0.0592
                }
            ],
            "bond_breakdown": {
                "average_maturity": {
                    "fund": 6.65,
                    "category": 7.81
                },
                "average_duration": {
                    "fund": 5.72,
                    "category": 5.64
                },
                "credit_quality": [
                    {
                        "grade": "AAA",
                        "weight": 0
                    }
                ]
            }
        }
    },
    "status": "ok"
}

ETFs families

/etfs/family

Retrieve a comprehensive list of exchange-traded fund (ETF) families, providing users with detailed information on various ETF groups available in the market. This endpoint is ideal for users looking to explore different ETF categories, compare offerings, or integrate ETF family data into their financial applications.

API credits cost

1 per request

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

fund_family

string

Filter by investment company that manages the fund

Example: iShares

Request example

Response

{
    "result": {
        "India": [
            "Aberdeen Standard Fund Managers Limited",
            "Aditya Birla Sun Life AMC Ltd"
        ],
        "United States": [
            "Aegon Asset Management UK PLC",
            "Ampega Investment GmbH",
            "Aviva SpA"
        ]
    },
    "status": "ok"
}

ETFs types

/etfs/type

The ETFs Types endpoint provides a concise list of ETF categories by market (e.g., Singapore, United States), including types like "Equity Precious Metals" and "Large Blend." It supports targeted investment research and portfolio diversification.

API credits cost

1 per request

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

fund_type

string

Filter by the type of fund

Example: Large Blend

Request example

Response

{
    "result": {
        "Singapore": [
            "Property - Indirect Asia",
            "Sector Equity Water"
        ],
        "United States": [
            "Asia-Pacific ex-Japan Equity",
            "EUR Flexible Allocation - Global"
        ]
    },
    "status": "ok"
}

Mutual funds

Mutual-fund-specific listings and snapshots: fund directories, issuer families, fund types, NAV history, dividend records, key ratios, and portfolio holdings. Ideal for long-term performance analysis and portfolio attribution.

MFs directory Useful

/mutual_funds/list

The mutual funds directory endpoint provides a daily updated list of mutual funds, sorted in descending order by their total assets value. This endpoint is useful for retrieving an organized overview of available mutual funds.

API credits cost

1 per request

Basic, Grow, and Pro plans (individual) and Venture plan (business) return up to 50 records. For complete data on over 140,000 Mutual Funds, upgrade to the Ultra plan (individual), Enterprise (business), or Custom plan (business).

symbol

string

Filter by symbol

Example: 1535462D

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG00HMMLCH1

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: LU1206782309

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 120678230

cik

string

The CIK of an instrument for which data is requested

Example: 95953

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

fund_family

string

Filter by investment company that manages the fund

Example: Jackson National

fund_type

string

Filter by the type of fund

Example: Small Blend

performance_rating

integer

Filter by performance rating from 0 to 5

Example: 4

risk_rating

integer

Filter by risk rating from 0 to 5

Example: 4

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

dp

integer

Number of decimal places for floating values

Default: 5

page

integer

Page number

Default: 1

outputsize

integer

Number of records in response

Default: 100

Request example

Response

{
    "result": {
        "count": 1000,
        "list": [
            {
                "symbol": "0P0001LCQ3",
                "name": "JNL Small Cap Index Fund (I)",
                "country": "United States",
                "fund_family": "Jackson National",
                "fund_type": "Small Blend",
                "performance_rating": 2,
                "risk_rating": 4,
                "currency": "USD",
                "exchange": "OTC",
                "mic_code": "OTCM"
            }
        ]
    },
    "status": "ok"
}

MF full data High demand

/mutual_funds/world

The mutual full data endpoint provides detailed information about global mutual funds. It returns a comprehensive dataset that includes a summary of the fund, its performance metrics, risk assessment, ratings, asset composition, purchase details, and sustainability factors. This endpoint is essential for users seeking in-depth insights into mutual funds on a global scale, allowing them to evaluate various aspects such as investment performance, risk levels, and environmental impact.

API credits cost

1000 per request

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of mutual fund

Example: 1535462D

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG00HMMLCH1

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: LU1206782309

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 120678230

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

dp

integer

Number of decimal places for floating values. Accepts value in range [0,11]

Default: 5

Request example

Response

{
    "mutual_fund": {
        "summary": {
            "symbol": "0P0001LCQ3",
            "name": "JNL Small Cap Index Fund (I)",
            "fund_family": "Jackson National",
            "fund_type": "Small Blend",
            "currency": "USD",
            "share_class_inception_date": "2021-04-26",
            "ytd_return": -0.02986,
            "expense_ratio_net": 0.001,
            "yield": 0,
            "nav": 10.09,
            "min_investment": 0,
            "turnover_rate": 0.32,
            "net_assets": 2400762112,
            "overview": "The fund invests, normally, at least 80% of its assets in the stocks...",
            "people": [
                {
                    "name": "John Doe",
                    "tenure_since": "2018-01-01"
                }
            ]
        },
        "performance": {
            "trailing_returns": [
                {
                    "period": "ytd",
                    "share_class_return": -0.02986,
                    "category_return": 0.2019,
                    "rank_in_category": 76
                }
            ],
            "annual_total_returns": [
                {
                    "year": 2024,
                    "share_class_return": 0.08546,
                    "category_return": 0.1119
                }
            ],
            "quarterly_total_returns": [
                {
                    "year": 2024,
                    "q1": 0.02358,
                    "q2": -0.03071,
                    "q3": 0.10099,
                    "q4": -0.00629
                }
            ],
            "load_adjusted_return": [
                {
                    "period": "1_year",
                    "return": 0.06139
                }
            ]
        },
        "risk": {
            "volatility_measures": [
                {
                    "period": "3_year",
                    "alpha": -9.12,
                    "alpha_category": -0.0939,
                    "beta": 1,
                    "beta_category": 0.0126,
                    "mean_annual_return": 0.45,
                    "mean_annual_return_category": 0.0117,
                    "r_squared": 69,
                    "r_squared_category": 0.8309,
                    "std": 23.15,
                    "std_category": 0.2554,
                    "sharpe_ratio": 0.04,
                    "sharpe_ratio_category": 0.005,
                    "treynor_ratio": -1.41,
                    "treynor_ratio_category": 0.0806
                }
            ],
            "valuation_metrics": {
                "price_to_earnings": 0.05695,
                "price_to_earnings_category": 20.63,
                "price_to_book": 0.55626,
                "price_to_book_category": 2.87,
                "price_to_sales": 0.97803,
                "price_to_sales_category": 1.34,
                "price_to_cashflow": 0.10564,
                "price_to_cashflow_category": 11.81,
                "median_market_capitalization": 2965,
                "median_market_capitalization_category": 4925,
                "3_year_earnings_growth": 16.32,
                "3_year_earnings_growths_category": 10.55
            }
        },
        "ratings": {
            "performance_rating": 2,
            "risk_rating": 4,
            "return_rating": 0
        },
        "composition": {
            "major_market_sectors": [
                {
                    "sector": "Industrials",
                    "weight": 0.1742
                }
            ],
            "asset_allocation": {
                "cash": 0.0043,
                "stocks": 0.9956,
                "preferred_stocks": 0,
                "convertables": 0,
                "bonds": 0,
                "others": 0
            },
            "top_holdings": [
                {
                    "symbol": "BBWI",
                    "name": "Bath & Body Works Inc",
                    "exchange": "NASDAQ",
                    "mic_code": "XNAS",
                    "weight": 0.00624
                }
            ],
            "bond_breakdown": {
                "average_maturity": {
                    "fund": 0,
                    "category": 1.97
                },
                "average_duration": {
                    "fund": 0,
                    "category": 1.64
                },
                "credit_quality": [
                    {
                        "grade": "U.S. Government",
                        "weight": 0
                    }
                ]
            }
        },
        "purchase_info": {
            "expenses": {
                "expense_ratio_gross": 0.0022,
                "expense_ratio_net": 0.001
            },
            "minimums": {
                "initial_investment": 0,
                "additional_investment": 0,
                "initial_ira_investment": 0,
                "additional_ira_investment": 0
            },
            "pricing": {
                "nav": 10.09,
                "12_month_low": 9.630000114441,
                "12_month_high": 12.10000038147,
                "last_month": 11.050000190735
            },
            "brokerages": []
        },
        "sustainability": {
            "score": 22,
            "corporate_esg_pillars": {
                "environmental": 3.73,
                "social": 10.44,
                "governance": 7.86
            },
            "sustainable_investment": false,
            "corporate_aum": 0.99486
        }
    },
    "status": "ok"
}

Summary

/mutual_funds/world/summary

The mutual funds summary endpoint provides a concise overview of global mutual funds, including key details such as fund name, symbol, asset class, and region. This endpoint is useful for quickly obtaining essential information about various mutual funds worldwide, aiding in the comparison and selection of funds for investment portfolios.

API credits cost

200 per request

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of mutual fund

Example: 1535462D

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG00HMMLCH1

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: LU1206782309

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 120678230

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

dp

integer

Number of decimal places for floating values. Accepts value in range [0,11]

Default: 5

Request example

Response

{
    "mutual_fund": {
        "summary": {
            "symbol": "0P0001LCQ3",
            "name": "JNL Small Cap Index Fund (I)",
            "fund_family": "Jackson National",
            "fund_type": "Small Blend",
            "currency": "USD",
            "share_class_inception_date": "2021-04-26",
            "ytd_return": -0.02986,
            "expense_ratio_net": 0.001,
            "yield": 0,
            "nav": 10.09,
            "min_investment": 0,
            "turnover_rate": 0.32,
            "net_assets": 2400762112,
            "overview": "The fund invests, normally, at least 80% of its assets in the stocks...",
            "people": [
                {
                    "name": "John Doe",
                    "tenure_since": "2018-01-01"
                }
            ]
        }
    },
    "status": "ok"
}

Performance High demand

/mutual_funds/world/performance

The mutual funds performances endpoint provides comprehensive performance data for mutual funds globally. It returns metrics such as trailing returns, annual returns, quarterly returns, and load-adjusted returns.

API credits cost

200 per request

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

One of these parameters is required

symbol

string

Symbol ticker of mutual fund

Example: 1535462D

figi

string

Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.

Example: BBG00HMMLCH1

isin

string

Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section

Example: LU1206782309

cusip

string

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section

Example: 120678230

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

dp

integer

Number of decimal places for floating values. Accepts value in range [0,11]

Default: 5

Request example

Response

{
    "mutual_fund": {
        "performance": {
            "trailing_returns": [
                {
                    "period": "ytd",
                    "share_class_return": -0.02986,
                    "category_return": 0.2019,
                    "rank_in_category": 76
                }
            ],
            "annual_total_returns": [
                {
                    "year": 2024,
                    "share_class_return": 0.08546,
                    "category_return": 0.1119
                }
            ],
            "quarterly_total_returns": [
                {
                    "year": 2024,
                    "q1": 0.02358,
                    "q2": -0.03071,
                    "q3": 0.10099,
                    "q4": -0.00629
                }
            ],
            "load_adjusted_return": [
                {
                    "period": "1_year",
                    "return": 0.06139
                }
            ]
        }
    },
    "status": "ok"
}

Risk

Read the original on twelvedata.com ↗