Symbol rolling returns
Returns over a rolling window, so a single lucky start date cannot flatter the record.
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.
symbolrollingReturns
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/rolling-returns" \
-H "Authorization: Bearer $MASSARI_TOKEN"Example response
{
"symbol": "AAPL",
"rollingReturns": {
"1M": [
{
"date": "2015-02-02",
"value": 8.506332877691003
},
{
"date": "2015-02-03",
"value": 11.67056903797694
}
],
"1Y": [
{
"date": "2015-12-31",
"value": -2.082189065410145
},
{
"date": "2016-01-04",
"value": 0.8422322980363495
}
],
"3M": [
{
"date": "2015-04-02",
"value": 15.0779065781812
},
{
"date": "2015-04-06",
"value": 20.33213358433159
}
],
"3Y": [
{
"date": "2018-01-02",
"value": 66.44380113070878
},
{
"date": "2018-01-03",
"value": 71.23916932608667
}
],
"6M": [
{
"date": "2015-07-02",
"value": 16.591437503355387
},
{
"date": "2015-07-06",
"value": 19.55364237847761
}
]
}
}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.