# Market capitalization (New)

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

> **Note:** This API endpoint 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.

## Parameters

- `symbol` (string, optional, see notes)
  Filter by symbol
  Example value: `AAPL`


- `figi` (string, optional, see notes)
  Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
  Example value: `BBG000B9Y5X2`


- `isin` (string, optional, see notes)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section
  Example value: `US0378331005`


- `cusip` (string, optional, see notes)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section
  Example value: `594918104`


- `exchange` (string, optional)
  Filter by exchange name
  Example value: `NASDAQ`


- `mic_code` (string, optional)
  Filter by market identifier code (MIC) under ISO 10383 standard
  Example value: `XNAS`


- `country` (string, optional)
  Filter by country name or alpha code, e.g., `United States` or `US`
  Example value: `United States`


- `start_date` (string, optional)
  Start date for market capitalization data retrieval.
Data will be returned from this date onwards.
Format `2006-01-02`
  Example value: `2023-01-01`


- `end_date` (string, optional)
  End date for market capitalization data retrieval.
Data will be returned up to and including this date.
Format `2006-01-02`
  Example value: `2023-12-31`


- `page` (integer, optional)
  Page number
  Default value: `1`


- `outputsize` (integer, optional)
  Number of records in response
  Default value: `10`


**Notes:**

 - At least one of the following parameters is required: `symbol`, `figi`, `isin`, `cusip`.

## Response

- `meta` (object)
  Meta information about the company
  - `symbol` (string)
    Ticker of the company
  - `name` (string)
    Name of the company
  - `currency` (string)
    Currency in which instrument is traded by ISO 4217 standard
  - `exchange` (string)
    Exchange name where the company is listed
  - `mic_code` (string)
    Market Identifier Code (MIC) under ISO 10383 standard
  - `exchange_timezone` (string)
    Exchange timezone

- `market_cap` (array of object)
  Market capitalization values
  - `date` (string)
    Market capitalization date
  - `value` (integer)
    Market capitalization value


## Example Request

```bash
curl "https://api.twelvedata.com/market_cap?symbol=AAPL&apikey=demo"
```

## Example Response

```json
{
    "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
        }
    ]
}
```