---
title: "Market capitalization"
method: GET
path: "/market_cap"
tags: ["fundamentals"]
---

# Market capitalization

`GET /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.

## Query parameters

- `symbol` string
- `figi` string
- `isin` string
- `cusip` string
- `exchange` string
- `mic_code` string
- `country` string
- `start_date` string
- `end_date` string
- `page` integer
- `outputsize` integer

## Response `200`

- object
  - `meta` object, required — Meta information about the company
    - `symbol` string, required — Ticker of the company
    - `name` string, required — Name of the company
    - `currency` string, required — Currency in which instrument is traded by ISO 4217 standard
    - `exchange` string, required — Exchange name where the company is listed
    - `mic_code` string, required — Market Identifier Code (MIC) under ISO 10383 standard
    - `exchange_timezone` string, required — Exchange timezone
  - `market_cap` object[], required — Market capitalization values
    - `date` string, required — Market capitalization date
    - `value` integer, required — Market capitalization value

## Other responses

- `400`
- `401`
- `403`
- `404`
- `414`
- `429`
- `500`

---

[API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)