Symbol compare

GET/v1/symbols/comparePromised whole

Several securities side by side on the same measures.

Parameters

idsqueryoptional

Response contract

Every field in the response is part of the contract.

Response fields

The top level keys a live response actually returned, read off the API rather than written down here.

symbolswindowrows

How this was verified

Called against 3 different subjects on the live API. Every field it returned, at every level, was compared with the contract above. Last checked August 18, 2026.

Request

curl "https://api.massari.ai/v1/symbols/compare?ids=AAPL,MSFT" \
  -H "Authorization: Bearer $MASSARI_TOKEN"

Example response

{
  "symbols": [
    "AAPL",
    "MSFT"
  ],
  "window": {
    "from": null,
    "to": null,
    "lookback_years": null
  },
  "rows": [
    {
      "symbol": "AAPL",
      "profile": {
        "symbol": "AAPL",
        "name": "Apple Inc.",
        "asset_type": "Common Stock",
        "sector": "Technology",
        "industry": "Consumer Electronics",
        "market_cap": "4464797286400",
        "net_assets": null,
        "pe_ratio": "35.08",
        "peg_ratio": "2.467",
        "dividend_yield": "0.003500",
        "beta": "1.086",
        "eps": "8.72",
        "expense_ratio": null
      },
      "risk_return": {
        "beta": 1.1043362628980953,
        "cagr": 21.626054447242193,
        "alpha": 15.301030738101664,
        "omega": 1.1369629055151715,
        "calmar": 0.2643837171303486,
        "period": {
          "to": "2026-08-17",
          "from": "1993-01-29",
          "tradingDays": 8442
        },
        "sharpe": 0.6808645299617445,
        "symbol": "AAPL",
        "sortino": 0.927839910637813,
        "treynor": 0.25930347999827114,
        "maxDrawdown": 81.79798166836403,
        "totalReturn": 71083.32168646634,
        "intermediates": {
          "varBench": 0.00013662695579722358,
          "omegaGains": 79.62443674028675,
          "omegaLosses": 70.0325721745583,
          "covAssetBench": 0.00015088210177624915,
          "stdBenchDaily": 0.011688753389357806,
          "meanBenchDaily": 0.00047916424091813946,
          "stdDailyReturn": 0.026494071145475657,
          "meanDailyReturn": 0.0011363422065784196,
          "downsideStdDaily": 0.01944179495882762,
          "arithAnnualReturn": 28.635823605776174,
          "arithAnnualBenchReturn": 12.074938871137114
        },
        "annualizedVolatility": 42.058034081148456,
        "correlationToBenchmark": 0.4872152024150193
      }
    },
    {
      "symbol": "MSFT",
      "profile": {
        "symbol": "MSFT",
        "name": "Microsoft Corporation",
        "asset_type": "Common Stock",
        "sector": "Technology",
        "industry": "Software - Infrastructure",
        "market_cap": "3678615371776",
        "net_assets": null,
        "pe_ratio": "27.63",
        "peg_ratio": "1.609",
        "dividend_yield": "0.007300",
        "beta": "1.099",
        "eps": "17.93",
        "expense_ratio": null
      },
      "risk_return": {
        "beta": 1.098596575789999,
        "cagr": 18.43603263867035,
        "alpha": 8.455900197234039,
        "omega": 1.1364897368349436,
        "calmar": 0.26569774687592607,
        "period": {
          "to": "2026-08-17",
          "from": "1993-01-29",
          "tradingDays": 8442
        },
        "sharpe": 0.7025084742134228,
        "symbol": "MSFT",
        "sortino": 1.009162721650868,
        "treynor": 0.19771941013305103,
        "maxDrawdown": 69.38723739828889,
        "totalReturn": 29084.640622151874,
        "intermediates": {
          "varBench": 0.00013662695579722358,
          "omegaGains": 60.58239362313731,
          "omegaLosses": 53.30659104045732,
          "covAssetBench": 0.00015009790579944136,
          "stdBenchDaily": 0.011688753389357806,
          "meanBenchDaily": 0.00047916424091813946,
          "stdDailyReturn": 0.01947761195810157,
          "meanDailyReturn": 0.000861959789442017,
          "downsideStdDaily": 0.013558950568073913,
          "arithAnnualReturn": 21.72138669393883,
          "arithAnnualBenchReturn": 12.074938871137114
        },
        "annualizedVolatility": 30.919750424732744,
        "correlationToBenchmark": 0.6592812546232608
      }
    }
  ]
}

A real response from the live API, captured August 18, 2026. Nothing was dropped, so this is the whole shape. Either way it is valid JSON.