Symbol drawdowns

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

Every peak-to-trough decline over the window, with the deepest ranked.

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.

seriessymboltopDrawdownsmaxDrawdownPct

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

Example response

{
  "series": [
    {
      "date": "1993-01-29",
      "drawdownPct": 0
    },
    {
      "date": "1993-02-01",
      "drawdownPct": 0
    }
  ],
  "symbol": "AAPL",
  "topDrawdowns": [
    {
      "duration": 1217,
      "startDate": "2000-03-22",
      "troughDate": "2003-04-17",
      "drawdownPct": 81.79798166836405,
      "recoveryDate": "2005-01-26"
    },
    {
      "duration": 1648,
      "startDate": "1993-02-01",
      "troughDate": "1997-12-23",
      "drawdownPct": 78.07196198234895,
      "recoveryDate": "1999-08-11"
    }
  ],
  "maxDrawdownPct": 81.79798166836405
}

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.