---
updatedAt: 2026-06-03T14:45:45.000Z
agentTools:
  projectIndex: https://docs.ortex.com/llms.txt
---

# Market Cap


<p>Daily market capitalisation for global equities, expressed in the security's local trading currency.</p>

<h3>Available Data Points:</h3>
<ul>
    <li><strong>Date:</strong> Date of the market cap value.</li>
    <li><strong>Market Cap:</strong> Market capitalisation in the local trading currency
        (shares outstanding x closing price).</li>
    <li><strong>Market Cap USD:</strong> The same market capitalisation converted to USD.</li>
    <li><strong>Currency:</strong> ISO code of the local trading currency (e.g. USD).</li>
</ul>

<p>Pass <code>from_date</code> and <code>to_date</code> (yyyy-mm-dd) for a daily series; set both to the same value
to read the market cap on a single date. Defaults to the last month when no dates are supplied.</p>

<h3>Resolving renamed, delisted or moved tickers (US only)</h3>
<p><code>ticker_as_of_date</code> (yyyy-mm-dd) selects <strong>which</strong> instrument the ticker refers
to, as of that date. It changes instrument resolution <strong>only</strong> &mdash; it does
<strong>not</strong> filter the returned data (the date range is still <code>from_date</code> /
<code>to_date</code>). Tickers get reused, renamed and delisted, so by default a ticker that is no longer
active returns <code>404</code> and a recycled ticker resolves to today's owner. With this set, the URL
path exchange is ignored and all US exchanges are searched for whoever held the ticker on that date,
letting you pull history for a company that has since changed ticker, delisted, or moved exchange. Omit
it for the current, unchanged behaviour; a non-US instrument with this parameter returns
<code>400</code>.</p>

<p><strong>Try it out!</strong> You can test the API with the <strong>trial key</strong> <code>TEST</code>. Simply include it in your request headers; either here, or add the header <code>"Ortex-Api-Key": "TEST"</code> to your http request.</p>


<p>
<strong>Trial key restrictions: </strong>A list of randomly selected rows will be returned</p>
<p><strong>Get full access!</strong> Get a key at <a href="https://app.ortex.com/apis" target="_blank">app.ortex.com/apis</a></p>


# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "ORTEX APIs",
    "version": "1.0",
    "description": "A revolutionary global equity analytics platform which identifies and analyses relevant data for your stocks."
  },
  "paths": {
    "/api/v1/stock/{exchange_symbol}/{ticker}/market_cap": {
      "get": {
        "operationId": "stock_market_cap_list",
        "description": "\n<p>Daily market capitalisation for global equities, expressed in the security's local trading currency.</p>\n\n<h3>Available Data Points:</h3>\n<ul>\n    <li><strong>Date:</strong> Date of the market cap value.</li>\n    <li><strong>Market Cap:</strong> Market capitalisation in the local trading currency\n        (shares outstanding x closing price).</li>\n    <li><strong>Market Cap USD:</strong> The same market capitalisation converted to USD.</li>\n    <li><strong>Currency:</strong> ISO code of the local trading currency (e.g. USD).</li>\n</ul>\n\n<p>Pass <code>from_date</code> and <code>to_date</code> (yyyy-mm-dd) for a daily series; set both to the same value\nto read the market cap on a single date. Defaults to the last month when no dates are supplied.</p>\n\n<h3>Resolving renamed, delisted or moved tickers (US only)</h3>\n<p><code>ticker_as_of_date</code> (yyyy-mm-dd) selects <strong>which</strong> instrument the ticker refers\nto, as of that date. It changes instrument resolution <strong>only</strong> &mdash; it does\n<strong>not</strong> filter the returned data (the date range is still <code>from_date</code> /\n<code>to_date</code>). Tickers get reused, renamed and delisted, so by default a ticker that is no longer\nactive returns <code>404</code> and a recycled ticker resolves to today's owner. With this set, the URL\npath exchange is ignored and all US exchanges are searched for whoever held the ticker on that date,\nletting you pull history for a company that has since changed ticker, delisted, or moved exchange. Omit\nit for the current, unchanged behaviour; a non-US instrument with this parameter returns\n<code>400</code>.</p>\n\n<p><strong>Try it out!</strong> You can test the API with the <strong>trial key</strong> <code>TEST</code>. Simply include it in your request headers; either here, or add the header <code>\"Ortex-Api-Key\": \"TEST\"</code> to your http request.</p>\n\n\n<p>\n<strong>Trial key restrictions: </strong>A list of randomly selected rows will be returned</p>\n<p><strong>Get full access!</strong> Get a key at <a href=\"https://app.ortex.com/apis\" target=\"_blank\">app.ortex.com/apis</a></p>\n",
        "summary": "Market Cap",
        "parameters": [
          {
            "in": "path",
            "name": "exchange_symbol",
            "schema": {
              "type": "string"
            },
            "description": "Exchange symbol (e.g. \"nyse\", \"nasdaq\"), MIC code (e.g. \"xnys\", \"xnas\") or two character ISO country code (e.g \"us\", \"ca\" for ALL country exchanges)",
            "required": true,
            "examples": {
              "NewYorkStockExchangeSymbol": {
                "value": "nyse",
                "summary": "New York Stock Exchange symbol"
              },
              "NASDAQSymbol": {
                "value": "nasdaq",
                "summary": "NASDAQ symbol"
              },
              "NewYorkStockExchangeMICCode": {
                "value": "xnys",
                "summary": "New York Stock Exchange MIC code"
              },
              "NASDAQMICCode": {
                "value": "xnas",
                "summary": "NASDAQ MIC code"
              },
              "AllUSExchanges": {
                "value": "us",
                "summary": "All US exchanges"
              },
              "AllCanadianExchanges": {
                "value": "ca",
                "summary": "All Canadian exchanges"
              }
            }
          },
          {
            "in": "query",
            "name": "from_date",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "description": "Start date of the market cap series. Format: yyyy-mm-dd. Default: one month ago.",
            "examples": {
              "DateFormat": {
                "value": "2024-09-24",
                "summary": "Date format"
              }
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "A page number within the paginated result set.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "required": false,
            "in": "query",
            "description": "Number of results to return per page.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "in": "path",
            "name": "ticker",
            "schema": {
              "type": "string"
            },
            "description": "Ticker symbol",
            "required": true
          },
          {
            "in": "query",
            "name": "ticker_as_of_date",
            "schema": {
              "type": "string"
            },
            "description": "**US instruments only.** Picks *which* instrument a ticker refers to, as of the given date (format `yyyy-mm-dd`).\n\n**What it does:** changes instrument *resolution* only. It does **not** filter or move the returned data — that stays controlled by the endpoint's own data parameters (such as `from_date` / `to_date`, or `as_of_date` on the options endpoints). Think of it as answering \"who owned this ticker on this date?\", not \"what data do I want back?\".\n\n**Why you need it:** tickers get reused, renamed and delisted over time (e.g. `FB` → `META`; `SPLK` was delisted when Cisco acquired Splunk). By default the endpoint matches the ticker on the exchange in the URL path to the **currently-active** instrument — so a ticker that no longer trades returns **404**, and a recycled ticker resolves to today's owner, not the historical one.\n\n**When set:** the URL path exchange is **ignored** and **all US exchanges** are searched for whichever instrument held the ticker on that date. This lets you pull history for a company that has since changed ticker, delisted, or moved exchange.\n\n**Rules:**\n- Omitted → current behaviour, exactly unchanged.\n- Present (any value, even blank or a future date) → as-of resolution is applied; a blank value defaults to today.\n- A non-US exchange / MIC / country code combined with this parameter returns **400**.\n\nNote: on the options endpoints this is distinct from `as_of_date`, which filters the option *data* snapshot — `ticker_as_of_date` only selects the instrument.",
            "examples": {
              "RenamedTicker,AsItWasMid-2018": {
                "value": "2018-06-01",
                "summary": "Renamed ticker, as it was mid-2018"
              },
              "DelistedName,WhileItStillTraded": {
                "value": "2024-03-01",
                "summary": "Delisted name, while it still traded"
              }
            }
          },
          {
            "in": "query",
            "name": "to_date",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "description": "End date of the market cap series. Format: yyyy-mm-dd. Default: today. For a single day, set from_date and to_date to the same value.",
            "examples": {
              "DateFormat": {
                "value": "2024-10-15",
                "summary": "Date format"
              }
            }
          }
        ],
        "tags": [
          "Market Cap"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedMarketCapList"
                },
                "examples": {
                  "MarketCap": {
                    "value": {
                      "paginationLinks": {
                        "next": "http://api.example.org/accounts/?page=4",
                        "previous": "http://api.example.org/accounts/?page=2"
                      },
                      "length": 123,
                      "rows": [
                        [
                          {
                            "date": "2024-09-24",
                            "market_cap": 2850000000000,
                            "market_cap_usd": 2850000000000,
                            "currency": "USD"
                          },
                          {
                            "date": "2024-09-25",
                            "market_cap": 2860000000000,
                            "market_cap_usd": 2860000000000,
                            "currency": "USD"
                          }
                        ]
                      ]
                    },
                    "summary": "Market cap time series"
                  }
                }
              }
            },
            "description": ""
          },
          "400": {
            "description": "Invalid request parameters"
          },
          "403": {
            "description": "Not authorized"
          },
          "404": {
            "description": "Data not found"
          },
          "429": {
            "description": "Rate limit exceeded"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "MarketCap": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date"
          },
          "marketCap": {
            "type": "integer"
          },
          "marketCapUsd": {
            "type": "integer"
          },
          "currency": {
            "type": "string"
          }
        },
        "required": [
          "currency",
          "date",
          "marketCap",
          "marketCapUsd"
        ]
      },
      "PaginatedMarketCapList": {
        "type": "object",
        "required": [
          "length",
          "paginationLinks",
          "rows"
        ],
        "properties": {
          "paginationLinks": {
            "type": "object",
            "example": {
              "next": "http://api.example.org/accounts/?page=4",
              "previous": "http://api.example.org/accounts/?page=2"
            }
          },
          "length": {
            "type": "integer",
            "example": 123
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MarketCap"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Ortex-Api-Key",
        "description": "Use test API key: `TEST` to get a limited result."
      }
    }
  },
  "servers": [
    {
      "url": "https://api.ortex.com/",
      "description": "Production"
    }
  ]
}
```