Monthly/Yearly Returns
This API provides market return predictions for various time horizons: 1 month, 6 months, 1 year and 3 years. It returns forecasted values and percentage changes for these periods, helping users assess potential market trends and make informed investment decisions.
Note: cocode can be obtained from the Search Stock or Company Basic Detail API.
Endpoint
https://connects.torusdigital.com/api/v1/returns/{exchange}/{cocode}/{reportType}Request Parameter
exchange
Y
The stock exchange for which the returns are being retrieved (e.g., "NSE", "BSE").
cocode
Y
The unique company code identifier.
reportType
Y
The type of report to retrieve. Report type (S - Single or C - Consolidated)
Request
curl -X 'GET' \
'https://connects.torusdigital.com/api/v1/returns/{exchange}/{cocode}/{reportType}' \
-H 'accept: application/json'Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://connects.torusdigital.com/api/v1/returns/{exchange}/{cocode}/{reportType}")
.header("Content-Type", "application/json")
.asString();package main
import (
"fmt"
"io/ioutil"
"net/http"
"strings"
)
func main() {
url := "https://connects.torusdigital.com/api/v1/returns/{exchange}/{cocode}/{reportType}"
method := "GET"
client := &http.Client{}
req, err := http.NewRequest(method, url, nil)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Content-Type", "application/json")
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}var settings = {
"url": "https://connects.torusdigital.com/api/v1/returns/{exchange}/{cocode}/{reportType}",
"method": "GET",
"timeout": 0,
"headers": {
"Content-Type": "application/json"
},
};
$.ajax(settings).done(function (response) {
console.log(response);
});Response
{
"1monthReturns": -0.44000733345555154,
"6monthReturns": 3.5932920590326516,
"1yearReturns": 27.61434766818348,
"3yearReturns": 32.12901684597961
}Response Parameters
1monthReturns
Predicted percentage return for the next month.
6monthReturns
Predicted percentage return for the next 6 months.
1yearReturns
Predicted percentage return for the next year.
3yearReturns
Predicted percentage return for the next 3 years.
Last updated