Stock Performance

Retrieves periodic performance for a stock.

Endpoint

Parameters

api_key string required
Your authentication key needed to make requests.

type string default: cumulative_return
The type of portfolio performance. Possible values are: "cumulative_return", "yearly_returns", "histogram", "drawdown", "rolling_beta" (requires benchmark), "rolling_volatility", "rolling_sharpe", "monthly_heatmap", "boxplot".

benchmark string
Benchmark for comparison. E.g. for the S&P 500 Total Return Index use ^SP500TR.

format string default: json
Defines return format of response. Options are json or csv. Default is json.

Example Request

curl -X GET "https://sensaai.com/data/v1/stock_performance/mmm?api_key=API_KEY"

import requests

url = "https://sensaai.com/data/v1/stock_performance/mmm/"
params = {
 "api_key": "API_KEY"  # Replace 'API_KEY' with your actual API key
}

response = requests.get(url, params=params)

if response.status_code == 200:
 data = response.json()
 print(data)
else:
 print(f"Request failed with status code {response.status_code}")

const https = require('https');

const url = "https://sensaai.com/data/v1/stock_performance/mmm/";
const params = {
api_key: '"API_KEY", // Replace 'API_KEY' with your actual API key
};

const requestUrl = new URL(url);
requestUrl.search = new URLSearchParams(params);

https.get(requestUrl, (response) => {
let data = '';

response.on('data', (chunk) => {
  data += chunk;
});

response.on('end', () => {
  if (response.statusCode === 200) {
    console.log(data);
  } else {
    console.error(`Request failed with status code ${response.statusCode}`);
  }
});
});

Response

Returns a list of stock performance if a valid stock ticker was provided. Returns an error otherwise.

[
  {
    "name": "MMM",
    "data": [
      {
        "date": "2000-01-03",
        "return": 0.0
      },
      {
        "date": "2000-01-04",
        "return": -0.039579967689822304
      },
      {
        "date": "2000-01-05",
        "return": 0.00928917609046831
      },
      {
        "date": "2000-01-06",
        "return": 0.06825525040387714
      },
      {
        "date": "2000-01-07",
        "return": 0.08925686591276238
      },
    ...more dates
    ]
  }
]