Average Volume

API QuantAPI Developer

Average traded volume for a whole stock set on a single date: for every constituent of the requested index or universe, the volume traded on that date and the trailing average daily volume over two short windows.

This API returns data for multiple stocks — every constituent of a market index, or of one of your own universes — for the specified date.

The windows count trading sessions, not calendar days. A 5-day average is the mean of the last five sessions the instrument actually traded, so a week containing a market holiday still averages five real sessions rather than four sessions and a gap. This is the convention volume vendors quote average daily volume on, and it is what makes the figure comparable across markets whose holiday calendars differ.

A weekend, a market holiday, or a date ahead of the latest fill resolves back to the most recent date that carries data, so a request never returns an empty response merely because the market was shut.

Available Data Points:

  • Date: The trading date the averages are as of. (YYYY-MM-DD format).
  • Exchange Symbol: Symbol of the exchange where the security trades.
  • Ticker: The ticker symbol associated with the security.
  • Company Name: The name of the company issuing the security.
  • Ortex Company ID: Unique id for a company.
  • Ortex Security ID: Unique id for a security issued by a company.
  • Ortex Tradable Item ID: Unique id for a listing of a security.
  • Volume: Shares traded on the date itself. Null if the instrument did not trade.
  • Avg Volume 5D: Mean shares traded per session over the trailing 5 trading days.
  • Avg Volume 10D: Mean shares traded per session over the trailing 10 trading days.

Share basis

Volumes are on the as-traded basis — the share count as it was quoted on the day, not restated into the current capital structure. This matters inside the window: our upstream vendor restates historical volume after a split, so averaging the restated figures would average days measured on two different share bases. Each day is converted back to as-traded before the window is applied, which also keeps the average in the same units as the volume column beside it.

Coverage

A window is null until the listing has traded enough sessions to fill it, so a recently listed instrument reports its 5-day average before its 10-day one. A window is never computed from fewer sessions than its name claims. Dates with no usable volume history are absent from the series rather than present with every window null.

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: Trial keys may be limited to a specific date range and set of regions. Requests outside the allowed regions or entirely outside the allowed date range are rejected; a date window that partially overlaps the allowed range is trimmed to it, reported in meta.restriction.

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

Query Params
string

The ORTEX index identifier used by this endpoint. Return one row per constituent of this market index, as of the requested date. Pick one from the examples, or type another ORTEX index identifier — the list covers the identifiers published today and is not exhaustive. Matching ignores case, so us500 and US500 are the same index. Supply exactly one of 'index' or 'universe' — sending both, or neither, returns 400 invalidSelection. An unrecognized index identifier returns 404 indexNotFound.

string

Return one row per constituent of one of your own universes, matched case-insensitively by name. Supply exactly one of 'index' or 'universe' — sending both, or neither, returns 400 invalidSelection. A name you do not own, or that does not exist, returns 404 universeNotFound. On a Quant key, a universe holding more than 250 constituents returns 409 universeSizeExceeded; nothing in it is changed. Manage your universes at /api/v11/universes/.

date

The single date to return data for (defaults to the latest available). Format: YYYY-MM-DD.

integer

Page number within the paginated result set. Must be >= 1. Defaults to 1.

integer

Number of rows per page. The default and the maximum allowed depend on the API tier; a value above the tier maximum is rejected with 400 invalidPageSize.

string
enum
Defaults to json

Response format. "json" (default) or "csv".

Allowed:
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/csv