Sign in
latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

fundamentals

Market capitalization

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.

get/market_cap

Query parameters

symbolstring

Filter by symbol

figistring

Filter by financial instrument global identifier (FIGI). This parameter is available on the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business) and above.

isinstring

Filter by international securities identification number (ISIN). ISIN access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

cusipstring

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

exchangestring

Filter by exchange name

mic_codestring

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

countrystring

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

start_datestring

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

end_datestring

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

pageinteger

Page number

outputsizeinteger

Number of records in response

Response

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