Market Cap

get

https://api.ortex.com/api/v1/stock/{exchange_symbol}/{ticker}/market_cap

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

Available Data Points:

Date: Date of the market cap value.
Market Cap: Market capitalisation in the local trading currency (shares outstanding x closing price).
Market Cap USD: The same market capitalisation converted to USD.
Currency: ISO code of the local trading currency (e.g. USD).

Pass from_date and to_date (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.

Resolving renamed, delisted or moved tickers (US only)

ticker_as_of_date (yyyy-mm-dd) selects which instrument the ticker refers to, as of that date. It changes instrument resolution only — it does not filter the returned data (the date range is still from_date / to_date). Tickers get reused, renamed and delisted, so by default a ticker that is no longer active returns 404 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 400.

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

Trial key restrictions: A list of randomly selected rows will be returned

Get full access! Get a key at app.ortex.com/apis

Path Params

exchange_symbol

string

required

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)

ticker

string

required

Ticker symbol

Query Params

from_date

date

Start date of the market cap series. Format: yyyy-mm-dd. Default: one month ago.

page

integer

A page number within the paginated result set.

page_size

integer

Number of results to return per page.

ticker_as_of_date

string

US instruments only. Picks which instrument a ticker refers to, as of the given date (format yyyy-mm-dd).

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?".

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.

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.

Rules:

Omitted → current behaviour, exactly unchanged.
Present (any value, even blank or a future date) → as-of resolution is applied; a blank value defaults to today.
A non-US exchange / MIC / country code combined with this parameter returns 400.

Note: 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.

to_date

date

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.

Responses

400

Invalid request parameters

403

Not authorized

404

Data not found

429

Rate limit exceeded

500

Internal server error

200