Symbol returns

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

Monthly and annual returns for the security and its benchmark, side by side.

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.

symbolmonthlyReturnsannualReturnsbenchmarkSymbolbenchmarkMonthlyReturnsbenchmarkAnnualReturns

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