ExanomicDocs
OverviewAuthenticationEnvironments
OverviewInflationLabor MarketInterest RatesGDP & OutputSeries EndpointsObservationsTreasury APICorrelation API
ExanomicDocs
GET/v2/analytics/correlation

Get Correlation Analysis

Calculate correlation coefficients between multiple economic series.

Compute statistical correlations between two or more economic data series over a specified time period. This endpoint is useful for identifying relationships between economic indicators, performing portfolio analysis, and understanding market dynamics. Returns Pearson correlation coefficients and supporting statistics.

Authentication: Your API key is required to access correlation analysis.

Query Parameters

NameTypeRequiredDescription
seriesstringRequiredComma-separated list of series IDs to correlate (minimum 2, maximum 10).
startDatestringOptionalStart date for correlation calculation (ISO 8601 format: YYYY-MM-DD).
endDatestringOptionalEnd date for correlation calculation (ISO 8601 format: YYYY-MM-DD).
method
default: pearson
stringOptionalCorrelation method: "pearson" (default), "spearman", "kendall".
series
stringRequired

Comma-separated list of series IDs to correlate (minimum 2, maximum 10).

startDate
stringOptional

Start date for correlation calculation (ISO 8601 format: YYYY-MM-DD).

endDate
stringOptional

End date for correlation calculation (ISO 8601 format: YYYY-MM-DD).

method
default: pearson
stringOptional

Correlation method: "pearson" (default), "spearman", "kendall".

Response Attributes

NameTypeRequiredDescription
series
arrayRequiredList of series IDs used in the analysis.
period
objectRequiredTime period used for calculation.
—startDate
stringRequiredStart date.
—endDate
stringRequiredEnd date.
correlationMatrix
arrayRequiredCorrelation matrix as nested arrays.
pairs
arrayRequiredPairwise correlation details.
—series1
stringRequiredFirst series ID.
—series2
stringRequiredSecond series ID.
—correlation
numberRequiredCorrelation coefficient (-1 to 1).
—pValue
numberOptionalStatistical significance p-value.
series
arrayRequired

List of series IDs used in the analysis.

period
objectRequired

Time period used for calculation.

startDate
stringRequired

Start date.

endDate
stringRequired

End date.

correlationMatrix
arrayRequired

Correlation matrix as nested arrays.

pairs
arrayRequired

Pairwise correlation details.

series1
stringRequired

First series ID.

series2
stringRequired

Second series ID.

correlation
numberRequired

Correlation coefficient (-1 to 1).

pValue
numberOptional

Statistical significance p-value.

Error Responses

400Bad request. Invalid parameters or insufficient series.
{
  "error": {
    "code": "invalid_parameter",
    "message": "At least 2 series are required for correlation analysis"
  }
}
401Unauthorized. Invalid or missing Bearer token.
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing Bearer token"
  }
}

Notes

  • Correlation values range from -1 to 1, where -1 is perfectly negative and 1 is perfectly positive.
  • You must provide at least 2 series and at most 10 in one request.
  • Pearson is the default method and captures linear relationships.
  • A p-value under 0.05 is often treated as statistically significant.
  • Correlation does not imply causation.

API Method

GET /v2/analytics/correlation

Example Usage

curl -X GET "https://api.exanomic.com/v2/analytics/correlation?series=UNRATE,CPIAUCSL&startDate=2020-01-01&endDate=2024-12-01" \
  -H "X-API-Key: your-api-key-here"

Example Response

{
  "series": [
    "UNRATE",
    "CPIAUCSL"
  ],
  "period": {
    "startDate": "2020-01-01",
    "endDate": "2024-12-01"
  },
  "correlationMatrix": [
    [
      1,
      -0.23
    ],
    [
      -0.23,
      1
    ]
  ],
  "pairs": [
    {
      "series1": "UNRATE",
      "series2": "CPIAUCSL",
      "correlation": -0.23,
      "pValue": 0.001
    }
  ]
}