POST/NorenWClientAPI/GetUnSttledTradingDate

Get Unsettled Trading Date

Fetch upcoming trading dates that haven't settled yet — useful for scheduling GTT validity windows and settlement-aware logic.

API Endpoint

Method	`POST`
URL	`https://api.shoonya.com/NorenWClientAPI/GetUnSttledTradingDate`
Content-Type	`application/x-www-form-urlencoded`
Payload	`jData=<JSON payload>&jKey=<AccessToken>`

Path spellingUnSttledTradingDate (missing the second "e" in "Settled") is exactly how the endpoint is spelled server-side — don't "fix" the typo in client code or it will 404.

Parameters

Field	Type	Required	Description
uid	string	Required	User ID of the logged-in user.

Request Examples

import requests, json

payload = {"uid": "AB1234"}
data = f"jData={json.dumps(payload)}&jKey={accessToken}"

response = requests.post(
    "https://api.shoonya.com/NorenWClientAPI/GetUnSttledTradingDate",
    data=data,
)
result = response.json()
dates = [row["trd_date"] for row in result.get("trd_date", [])]
print("Unsettled trading dates:", dates)

const payload = { uid: "AB1234" };
const data = `jData=${JSON.stringify(payload)}&jKey=${accessToken}`;

const res = await fetch("https://api.shoonya.com/NorenWClientAPI/GetUnSttledTradingDate", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: data,
});
const result = await res.json();
console.log("Unsettled trading dates:", (result.trd_date || []).map(r => r.trd_date));

curl -X POST https://api.shoonya.com/NorenWClientAPI/GetUnSttledTradingDate \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode 'jData={"uid":"AB1234"}' \
  --data-urlencode "jKey=$ACCESS_TOKEN"

Response

json

// Success
{
  "stat": "OK",
  "request_time": "10052021152900",
  "trd_date": [
    { "trd_date": "28-04-2021" },
    { "trd_date": "29-04-2021" },
    { "trd_date": "30-04-2021" }
  ]
}

// Failure
{
  "stat": "Not_Ok",
  "emsg": "Session Expired : Invalid Session Key"
}

Field	Description
stat	`OK` or `Not_Ok`.
request_time	Present only on success.
trd_date	Array of `{ trd_date }` objects listing unsettled trading dates.
emsg	Present only on failure.

Best Practices

Parse trd_date strings as DD-MM-YYYY, not MM-DD-YYYY — a naive date parser in a US-locale environment will silently misread the month and day for any date past the 12th.
Refresh this list once per session rather than hardcoding a settlement calendar — exchange holidays and settlement cycles shift.
Use it to gate any settlement-dependent logic (e.g. deciding when a delivery-based position becomes eligible for further action) rather than computing T+1/T+2 manually from the current date.

Edit this page on GitHub

← Previous

Get Enabled GTT Orders

Set Alert