Skip to content

Market · Status, sessions and calendar

Market breadth

Advancers, decliners, unchanged, up and down volume of one session.
On this page

Market breadth of one exchange date: the stocks that closed higher, lower and unchanged against the session before, the advance-decline ratio (null with no decliners), the shares traded in advancing and in declining stocks and up_volume_share, the advancing volume as a fraction of advancing plus declining volume (null when neither traded). Without date the latest completed session is used; a date that is not a session answers 422 data_unavailable.

Example request

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

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

Parameters

1 parameter, none required.

ParameterType and limitsDescription
datequeryoptionalstringdateExchange date, YYYY-MM-DD. Defaults to the latest completed session.

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

  • dataobjectrequiredMarket breadth of one session.9 fields inside
    • advance_decline_rationumber | nullrequiredAdvancers divided by decliners.
    • advancersintegerrequiredStocks that closed higher.
    • datestringdaterequiredSession date.
    • declinersintegerrequiredStocks that closed lower.
    • down_volumenumberrequiredShares traded in declining stocks.
    • total_issuesintegerrequiredStocks compared.
    • unchangedintegerrequiredStocks that closed unchanged.
    • up_volumenumberrequiredShares traded in advancing stocks.
    • up_volume_sharenumber | nullrequiredAdvancing volume as a fraction of advancing plus declining volume (0 to 1).
  • metaobjectrequiredMeta object

Example response

{
  "data": {
    "advance_decline_ratio": 1.743,
    "advancers": 3120,
    "date": "2026-10-15",
    "decliners": 1790,
    "down_volume": 1400000000,
    "total_issues": 5120,
    "unchanged": 210,
    "up_volume": 3100000000,
    "up_volume_share": 0.6889
  },
  "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.