MASSARIdocsRequest access

Symbol crisis

GET/v1/symbols/{symbol}/crisisPromised whole

How the security behaved through named market stress periods.

Parameters

  • symbolpathrequired

    Ticker symbol, case-insensitive.

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.

eventsperiodsymbol

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/AAPL/crisis" \
  -H "Authorization: Bearer $MASSARI_TOKEN"

Example response

{
  "events": [
    {
      "id": "dotcom",
      "end": "2002-10-09",
      "label": "Dot-com Crash",
      "shock": {
        "lowDate": "2000-05-23",
        "endPrice": 0.6568,
        "highDate": "2000-03-22",
        "lowPrice": 0.6428,
        "highPrice": 1.0801,
        "windowEnd": "2000-05-24",
        "startPrice": 0.942,
        "maxDrawdown": -31.762208067940545,
        "windowStart": "2000-03-10",
        "periodReturn": -30.276008492568995,
        "recoveryDate": "2000-09-01",
        "recoveryDays": 101
      },
      "start": "2000-03-10",
      "lowDate": "2002-10-09",
      "category": "financial",
      "endPrice": 0.2036,
      "highDate": "2000-03-22",
      "lowPrice": 0.2036,
      "shockEnd": "2000-05-24",
      "highPrice": 1.0801,
      "prolonged": {
        "lowDate": "2002-10-09",
        "endPrice": 0.2036,
        "highDate": "2000-03-22",
        "lowPrice": 0.2036,
        "highPrice": 1.0801,
        "windowEnd": "2002-10-09",
        "startPrice": 0.942,
        "maxDrawdown": -78.3864118895966,
        "windowStart": "2000-03-10",
        "periodReturn": -78.3864118895966,
        "recoveryDate": "2004-11-24",
        "recoveryDays": 777
      },
      "windowEnd": "2002-10-09",
      "startPrice": 0.942,
      "description": "Nasdaq peaked Mar 10, 2000 then collapsed 78% over 2.5 years",
      "maxDrawdown": -78.3864118895966,
      "sma_context": {
        "broke_200sma": true,
        "price_vs_50sma": 14.28,
        "price_vs_200sma": 57.7,
        "below_200sma_at_start": false
      },
      "windowStart": "2000-03-10",
      "periodReturn": -78.3864118895966,
      "recoveryDate": "2004-11-24",
      "recoveryDays": 777,
      "forward_returns": {
        "1y": -70.38,
        "3m": -23.86,
        "6m": -6.37
      },
      "stress_correlation": {
        "shift": 0.65,
        "pre_crisis": 47.52,
        "during_crisis": 78.39
      }
    },
    {
      "id": "sept11",
      "end": "2001-11-01",
      "label": "9/11 Attacks",
      "shock": {
        "lowDate": "2001-09-20",
        "endPrice": 0.2357,
        "highDate": "2001-09-19",
        "lowPrice": 0.2349,
        "highPrice": 0.255,
        "windowEnd": "2001-09-21",
        "startPrice": 0.2545,
        "maxDrawdown": -7.70137524557957,
        "windowStart": "2001-09-17",
        "periodReturn": -7.387033398821222,
        "recoveryDate": "2001-10-11",
        "recoveryDays": 21
      },
      "start": "2001-09-11",
      "lowDate": "2001-10-03",
      "category": "geopolitical",
      "endPrice": 0.2785,
      "highDate": "2001-10-25",
      "lowPrice": 0.2244,
      "shockEnd": "2001-09-21",
      "highPrice": 0.2875,
      "prolonged": {
        "lowDate": "2001-10-03",
        "endPrice": 0.2785,
        "highDate": "2001-10-25",
        "lowPrice": 0.2244,
        "highPrice": 0.2875,
        "windowEnd": "2001-11-01",
        "startPrice": 0.2545,
        "maxDrawdown": -11.827111984282912,
        "windowStart": "2001-09-17",
        "periodReturn": 9.4302554027505,
        "recoveryDate": "2001-10-11",
        "recoveryDays": 8
      },
      "windowEnd": "2001-11-01",
      "startPrice": 0.2545,
      "description": "Markets closed 4 days, S&P fell 12% in first week of trading",
      "maxDrawdown": -11.827111984282912,
      "sma_context": {
        "broke_200sma": false,
        "price_vs_50sma": -13.83,
        "price_vs_200sma": -15.4,
        "below_200sma_at_start": true
      },
      "windowStart": "2001-09-17",
      "periodReturn": 9.4302554027505,
      "recoveryDate": "2001-10-11",
      "recoveryDays": 8,
      "forward_returns": {
        "1y": -12.89,
        "3m": 20.04,
        "6m": 46.25
      },
      "stress_correlation": {
        "shift": 0.85,
        "pre_crisis": 6.38,
        "during_crisis": 11.83
      }
    }
  ],
  "period": {
    "to": "2026-08-17",
    "from": "1993-01-29",
    "tradingDays": 8442
  },
  "symbol": "AAPL"
}

A real response from the live API, captured August 18, 2026. This one is CUT: long arrays, wide objects and long strings were trimmed to keep it readable, so treat it as a sample of the shape rather than all of it. Either way it is valid JSON.

Book a meeting