Skip to content

Stocks · Statistics

Stocks correlations

Return correlation and beta between two or three stocks over a rolling window.
GET/v1/stocks/correlationsstocksCorrelations
On this page

Pearson correlation and beta of the daily log returns of two or three stocks over their last window common sessions (20 to 252), as a matrix and as pairs. Beta is of the first symbol of a pair against the second. A symbol without daily bars is listed in meta.coverage.missing and every pair with it is null; fewer than 10 paired returns also give null. One daily-bar read per symbol, split-adjusted; no prices are returned. The figures use a longer lookback than the dated rows your plan's history window allows (the window limits the rows returned, not the lookback a statistic is computed from); this route returns no dated rows.

Example request

curl -sS --get "https://api.ordermap.si/v1/stocks/correlations" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY" \
  --data-urlencode symbols=AAPL,MSFT,NVDA

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

Parameters

2 parameters, 1 required.

ParameterType and limitsDescription
symbolsqueryrequiredarray<string>comma-separated in one parameter1 to 3 itemseach at most 11 characterspattern ^[A-Za-z]{1,6}(\.[A-Za-z0-9]{1,4})?$Two or three different ticker symbols, comma separated.
windowqueryoptionalintegerdefault 60min 20max 252Number of daily returns, 20 to 252.

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

  • dataobjectrequiredReturn correlations of two or three symbols.9 fields inside
    • matrixarray<array<number>>requiredCorrelation matrix in the order of symbols; null where it cannot be computed.
    • pairsarray<object>requiredEvery pair once.5 fields inside
      • astringrequiredFirst symbol.
      • bstringrequiredSecond symbol.
      • betanumber | nullrequiredBeta of a's returns against b's: covariance over the variance of b.
      • correlationnumber | nullrequiredPearson correlation of the daily log returns, -1 to 1.
      • observationsintegerrequiredPaired daily returns used.
    • symbolsarray<string>requiredThe symbols, in request order.
    • windowintegerrequiredDaily returns the correlation covers.
  • metaobjectrequiredMeta object

Example response

{
  "data": {
    "matrix": [
      [
        1,
        0.81
      ],
      [
        0.81,
        1
      ]
    ],
    "pairs": [
      {
        "a": "AAPL",
        "b": "MSFT",
        "beta": 1.12,
        "correlation": 0.81,
        "observations": 60
      }
    ],
    "symbols": [
      "AAPL",
      "MSFT"
    ],
    "window": 60
  },
  "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.