# Crypto Asset Correlation Matrix

> Crypto Asset Correlation Matrix is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Computes a correlation matrix of daily returns, annualized volatility, and return percentages for 2–8 crypto assets over up to 2 years, identifying the least correlated pair for diversification and hedging.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/crypto-correlation?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-asset-correlation-matrix-7dc3c8e5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vws7QwPnOsCut5YCnv6MV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability crypto-asset-correlation-matrix-7dc3c8e5 -d '<json body>'
```

Example prompt: What's the correlation matrix and annualized volatility for BTC, ETH, SOL, and AVAX over the last 180 days? I want to know which pair is least correlated for diversification.

## When to prefer this

Choose this endpoint when you need a quantitative correlation and volatility analysis across multiple crypto assets simultaneously, especially for portfolio construction, diversification assessment, or hedging decisions. It is ideal when you want both the full pairwise correlation matrix and per-asset risk metrics (return and volatility) in a single call. Prefer it over manual price fetching + computation when you need fast, pre-computed results sourced from DefiLlama without setting up your own data pipeline.

## Known failure modes

- Fewer than 2 or more than 8 coins provided — request rejected
- Invalid coin symbol not recognized by DefiLlama — missing or null data for that asset
- Days parameter outside 14–730 range — validation error
- Insufficient price history for a coin over the requested period — partial or null results
- Network or DefiLlama upstream failure — service unavailable error

## How this service works

Correlation matrix of daily returns for 2-8 crypto assets over up to 2 years, with each asset's return and annualized volatility and the least correlated pair. For diversification and hedging. Prices from DefiLlama.

## Output

Returns a JSON object with: the number of days analyzed, a correlation matrix (n×n, values from -1 to 1) for all requested assets, per-asset return percentage and annualized volatility, and the least correlated pair with its correlation coefficient. Price data sourced from DefiLlama.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "coins"
     ],
     "properties": {
      "days": {
       "type": "integer",
       "description": "14-730, default 90"
      },
      "coins": {
       "type": "string",
       "description": "Comma-separated, e.g. BTC,ETH,SOL"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "days": {
       "type": [
        "number",
        "null"
       ]
      },
      "note": {
       "type": [
        "string",
        "null"
       ]
      },
      "assets": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "BTC": {
         "type": [
          "object",
          "null"
         ],
         "properties": {
          "return_pct": {
           "type": [
            "number",
            "null"
           ]
          },
          "annual_volatility_pct": {
           "type": [
            "number",
            "null"
           ]
          }
         }
        },
        "ETH": {
         "type": [
          "object",
          "null"
         ],
         "properties": {
          "return_pct": {
           "type": [
            "number",
            "null"
           ]
          },
          "annual_volatility_pct": {
           "type": [
            "number",
            "null"
           ]
          }
         }
        },
        "SOL": {
         "type": [
          "object",
          "null"
         ],
         "properties": {
          "return_pct": {
           "type": [
            "number",
            "null"
           ]
          },
          "annual_volatility_pct": {
           "type": [
            "number",
            "null"
           ]
          }
         }
        }
       }
      },
      "correlation": {
       
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "days": 91,
  "note": "1 = move together, 0 = unrelated, -1 = opposite. Price source: DefiLlama.",
  "assets": {
   "BTC": {
    "return_pct": 36.32,
    "annual_volatility_pct": 39.23
   },
   "ETH": {
    "return_pct": 51.64,
    "annual_volatility_pct": 48.08
   },
   "SOL": {
    "return_pct": 46.61,
    "annual_volatility_pct": 54.06
   }
  },
  "correlation": {
   "BTC": {
    "BTC": 1,
    "ETH": 0.881,
    "SOL": 0.824
   },
   "ETH": {
    "BTC": 0.881,
    "ETH": 1,
    "SOL": 0.767
   },
   "SOL": {
    "BTC": 0.824,
    "ETH": 0.767,
    "SOL": 1
   }
  },
  "least_correlated_pair": {
   "a": "ETH",
   "b": "SOL",
   "correlation": 0.767
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-asset-correlation-matrix-7dc3c8e5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)