Skip to content

Stocks · Statistics

Stocks seasonality

Average return, median return and win rate of a stock by calendar month and by weekday.
GET/v1/stocks/seasonalitystocksSeasonality
On this page

How one stock has behaved by calendar month and by weekday over the last years (3 to 20): the mean and median return in percent and the share of positive observations. Monthly returns compound the daily returns of each complete month (the running month is left out); weekday returns are simple daily returns. Months or weekdays without observations are null. Split-adjusted daily bars read in at most three requests. The statistics use all the years requested whatever your plan's history window; the window limits the dated rows returned, and this route returns none. No prices are returned.

Example request

curl -sS --get "https://api.ordermap.si/v1/stocks/seasonality" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY" \
  --data-urlencode symbol=AAPL

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

Parameters

2 parameters, 1 required.

ParameterType and limitsDescription
symbolqueryrequiredstringat most 11 characterspattern ^[A-Za-z]{1,6}(\.[A-Za-z0-9]{1,4})?$Ticker symbol, for example AAPL.
yearsqueryoptionalintegerdefault 10min 3max 20Years of history, 3 to 20.

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

  • dataobjectrequiredSeasonality of one stock.14 fields inside
    • by_montharray<object>requiredTwelve rows, January first.5 fields inside
      • average_return_pctnumber | nullrequiredMean monthly return in percent (daily returns compounded within the month).
      • median_return_pctnumber | nullrequiredMedian monthly return in percent.
      • monthintegerCalendar month, 1 (January) to 12.
      • observationsintegerrequiredMonths behind the figures.
      • win_ratenumber | nullrequiredShare of months with a positive return, 0 to 1.
    • by_weekdayarray<object>requiredFive rows, Monday first.5 fields inside
      • average_return_pctnumber | nullrequiredMean daily return in percent.
      • median_return_pctnumber | nullrequiredMedian daily return in percent.
      • observationsintegerrequiredDays behind the figures.
      • weekdayintegerWeekday, 1 (Monday) to 5 (Friday).
      • win_ratenumber | nullrequiredShare of days with a positive return, 0 to 1.
    • symbolstringrequiredSymbol.
    • yearsintegerrequiredYears of history requested.
  • metaobjectrequiredMeta object

Example response

{
  "data": {
    "by_month": [
      {
        "average_return_pct": 2.31,
        "median_return_pct": 1.9,
        "month": 1,
        "observations": 10,
        "win_rate": 0.7
      }
    ],
    "by_weekday": [
      {
        "average_return_pct": 0.06,
        "median_return_pct": 0.08,
        "observations": 520,
        "weekday": 1,
        "win_rate": 0.54
      }
    ],
    "symbol": "AAPL",
    "years": 10
  },
  "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.