User Limits

GET /limit/getLimits

Gets the user cash balances, available margin for trading in equity and commodity segments.

Sample Code

cURL

curl -X GET 'https://tradeapi.samco.in/limit/getLimits' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'x-session-token: <SESSION_TOKEN>'

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Sample {
  public static void main(String[] args) throws Exception {
    HttpClient client = HttpClient.newHttpClient();

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://tradeapi.samco.in/limit/getLimits"))
        .header("Content-Type", "application/json")
        .header("Accept", "application/json")
        .header("x-session-token", "<SESSION_TOKEN>")
        .GET()
        .build();

    HttpResponse<String> response =
        client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  }
}

NodeJs

(async () => {
  const headers = {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-session-token': '<SESSION_TOKEN>',
  };

  const response = await fetch('https://tradeapi.samco.in/limit/getLimits', {
    method: 'GET',
    headers,
  });

  const data = await response.json();
  console.log(data);
})();

Python

import requests
import json

headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'x-session-token': '<SESSION_TOKEN>',
}

r = requests.get('https://tradeapi.samco.in/limit/getLimits',
  headers=headers)

print(r.json())

Sample responses

200

{
    "serverTime": "10/04/24 13:29:07",
    "msgId": "77bb4c9b-17fc-4465-8e30-02e80eaff78c",
    "status": "Success",
    "statusMessage": "User Limit details retrieved successfully",
    "equityLimit": {
        "grossAvailableMargin": "0.00",
        "payInToday": "0",
        "notionalCash": "0",
        "marginUsed": "0",
        "netAvailableMargin": "0.00"
    },
    "commodityLimit": {
        "grossAvailableMargin": "0.00",
        "payInToday": "0",
        "notionalCash": "0",
        "marginUsed": "0",
        "netAvailableMargin": "0.00"
    }
}

Response Schema

Status Code 200

Name	Type	Description
serverTime	string	Time at Server.
msgId	string	This is a unique identifier for every request into the system. Please quote this identifier to the support team if you face issues with the API request.
status	string	The status of the API response. It can be either 'Success' or 'Failure'.
statusMessage	string	A message describing the result of the API call.
grossAvailableMargin	string	Total amount of margins or balances available for trading. Opening balance for the current day.
payInToday	string	Current day deposited amount.
notionalCash	string	Additional limit that may or may not be given by RMS for trading.
collateralMarginAgainstShares	string	Margin against shares offered by SAMCO to their clients for trading in stocks and shares.
marginUsed	string	The amount deducted from the opening balance for trading on the current day, and the amount blocked for creating a position when the user places an order.
netAvailableMargin	string	Actual margin available with the user for trading after making all necessary adjustments.