Skip to content

Stocks · Statistics

Stocks sectors

Sector rollup of the large-cap universe: average and cap-weighted change, advancers, decliners.
GET/v1/stocks/sectorsstocksSectors
On this page

The companies of the market map (/v1/stocks/market-map: about a hundred of the largest US companies) grouped by approximate sector: the number of companies, the mean, median and market-capitalization-weighted percentage change against the previous close, the companies up and down and their combined dollar volume today. A company without a price change adds to the count only; companies without a sector are grouped as Unclassified. The universe is the platform's large-cap list, not the whole market.

Example request

curl -sS "https://api.ordermap.si/v1/stocks/sectors" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY"

Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.

Parameters

This endpoint takes no parameters.

Response

StatusMeaningBody
200Successful response.Schema below
400Invalid, unknown or repeated parameters, or an invalid cursor.Error object
401Missing or invalid API key.Error object
403The plan, dataset release or account state does not allow this request.Error object
422The request is valid but no data exists for it.Error object
429Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-AfterError object
500Internal error.Error object
503Data temporarily unavailable; retry after Retry-After seconds.Retry-AfterError object
504The request timed out.Error object

Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.

200 response body

  • dataarray<object>required8 fields inside
    • advancersintegerrequiredCompanies trading above the previous close.
    • average_change_pctnumber | nullrequiredMean change against the previous close, in percent.
    • cap_weighted_change_pctnumber | nullrequiredChange weighted by market capitalization, in percent.
    • companiesintegerrequiredCompanies of the universe in the sector.
    • declinersintegerrequiredCompanies trading below the previous close.
    • dollar_volumenumber | nullrequiredCombined shares traded times price today, in dollars.
    • median_change_pctnumber | nullrequiredMedian change in percent.
    • sectorstringrequiredApproximate market sector.
  • metaobjectrequiredMeta object

Example response

{
  "data": [
    {
      "advancers": 14,
      "average_change_pct": 0.84,
      "cap_weighted_change_pct": 1.12,
      "companies": 18,
      "decliners": 4,
      "dollar_volume": 41000000000,
      "median_change_pct": 0.7,
      "sector": "Information Technology"
    }
  ],
  "meta": {
    "as_of": 1760659200123,
    "coverage": {
      "complete": true
    },
    "delay_ms": 0,
    "delayed": false,
    "request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
    "source": "sip"
  }
}

Values are illustrative. Missing values are null, never 0.