Noren Rest API (Original)
Noren Rest API (Original)
1
2
TABLE OF CONTENTS
INTRODUCTION 8
Watch Lists 23
Get WatchList Names 23
Get WatchList 24
Search Scrips 26
Add Scrip to Watch List 29
Delete Scrip to Watch List 30
Get SecurityInfo 31
Get Quotes 35
Get list of predefined MWs 39
Get list of predefined MW scrips 40
3
Multi Leg Order Book 57
Single Order History 60
Trade Book 65
Positions Book 69
Product Conversion 72
Market Info 83
Get Index List 83
Get Top List Names 85
Get Top List 87
Get Time Price Data (Chart data) 90
Get Option Chain 93
Exch Msg 94
Get Broker Msg 95
Span Calculator 97
Alerts 98
Set Alert 98
Cancel Alert 100
Modify Alert 101
Get Pending Alert 102
Get Enabled Alert Types 104
Place GTT Order 105
Modify GTT Order 107
Cancel GTT Order 109
Get Pending GTT Order 110
Get Enabled GTTs 112
Get UnSettled Trading date: 113
Funds 115
Get Max Payout Amount: 115
Get Content Basket 116
Get Content list 117
4
Connect 120
Subscribe Touchline 120
Unsubscribe Touchline 122
Subscribe Depth 123
Unsubscribe Depth 129
Subscribe Order Update 130
Unsubscribe Order Update 132
Annexure 132
Alert Type: 132
5
Version History
1.6.0 Option Chain added Return 10 strikes above and below the given Price, to
load the option chain screen.
Span calculator Provides span and exposure value for given positions
added
/SingleOrdHist and
/GetIndexList added
Url encoded tsym In Place, Modify Order, Order Margin, Option Chain,
support for special Production conversion.
chars.
6
LoginApi Added product enabled, exchange enabled, account
id, watch list, user name
1.12.0 User Details / Login Additional fields added to User Details / Login API /
API / Holding API Holding API
1.14.0 Order Update Missing fields added in Order Update web socket
1.15.0 Get Quote Added Get quote API for getting symbols
7
INTRODUCTION
Kambala Solutions is a solution oriented firm indulged in serving financial
organizations with innovative products and services. We understand the new challenges
and obstacles which are continuously arising for businesses with rapid advances in
technology and environment, they could only be tackled with efficient and effective
approaches. We have expertise in building high throughput, low latency distributed
applications that can support a large concurrent user base.
Noren OMS solution is built keeping in mind the large and diverse Indian broking
industry. Few of the prominent coverages are Order Execution, Algo Trading, Exchange
connectivity and Risk Mitigation. The Noren OMS team strives to serve ever changing
requirements with agility and personal touch. Noren OMS is continuously being tested
for stability, high scalability and low latency in mind.
8
Login and User Details
Login
Request to be POSTed to uri : /NorenWClientTP/QuickAuth
Request Details :
Parameter Possible value Description
Name
imei* Send mac if users logs in for desktop, imei is from mobile
source API
9
Example:
curl https://apitest.kambala.co.in/NorenWClientTP/QuickAuth \
-d "jData={ \"apkversion\": \"1.0.0\", \"uid\": \"VIDYA\", \"pwd\": \"s3cur3Id\", \"factor2\":
\"31-08-2017\", \"imei\": \"134243434\", \"source\": \"API\"}“
Response Details :
Response data will be in json format with below fields.
Json Fields Possible Description
value
actid Account id
email Email Id
brkname Broker id
10
"lastaccesstime": "1589899727"
}
Logout
Request to be POSTed to uri : /NorenWClientTP/Logout
Request Details :
Parameter Possible value Description
Name
Response Details :
Response data will be in json format with below fields.
Json Fields Possible Description
value
11
"request_time":"10:43:41 28-05-2020"
}
Forgot Password
Request to be POSTed to uri : /NorenWClientTP/ForgotPassword
Request Details :
Parameter Possible value Description
Name
uid* User Id
Response Details :
Response data will be in json format with below fields.
Json Fields Possible Description
value
12
"stat":"Ok"
}
Change Password
Request to be POSTed to uri : /NorenWClientTP/Changepwd
Request Details :
Parameter Possible value Description
Name
uid* User Id
Response Details :
Response data will be in json format with below fields.
Json Fields Possible Description
value
13
Sample Success Response :
{
"request_time":"10:20:04 27-05-2020",
"stat":"Ok",
“dmag”:”Password Change Success. Your new password will expire in 15”
}
Request Details :
Parameter Possible value Description
Name
uid* User Id
Response Details :
Response data will be in json format with below fields.
Json Fields Possible Description
value
14
request_time This will be present only if password change succeeds.
Request Details :
Parameter Possible value Description
Name
uid* User Id
15
ipaddr global Ip of internet access
Response Details :
Response data will be in json format with below fields.
Get HS Token
Request to be POSTed to uri : /NorenWClientTP/GetHsToken
16
Request Details :
Parameter Possible value Description
Name
uid* User Id
Response Details :
Response data will be in json format with below fields.
Json Fields Possible Description
value
Validate HS Token
Request to be POSTed to uri : /NorenWClientTP/ValidateHsToken
(To be used only from server, Call this url from Browser / Client Side APKs)
Request Details :
Parameter Possible value Description
Name
Response Details :
17
Response data will be in plain text format TRUE if Token is valid and FALSE for invalid User Id
or Token.
1. Trading site will call the third party url on user clicking the specified link (eg:Back Office login)
2. Trading site will pass the User id , Token and Client ID to the the third party url
3. Third Party application/web server will make a server call to our web server using this “Validate HS Token”
Url.
4. If Trading site web server says ok then Third party application will provide access to the user/client
User Details
Request to be POSTed to uri : /NorenWClientTP/UserDetails
Request Details :
Parameter Possible value Description
Name
Response Details :
orarr Json array of strings with enabled price types for user
18
brkname Broker id
brnchid Branch id
actid
19
{ “prd”:"B",
“s_prdt_ali” : “Bracket Order”,
“exch” : [“NSE”, “BSE”, “NFO”]
}
],
"exarr": [
"NSE",
"NFO"
],
"orarr": [
"MKT",
"LMT",
"SL-LMT",
"SL-MKT",
"DS",
"2L",
"3L",
"4L"
],
"brkname": "VIDYA",
"brnchid": "VIDDU",
"email": "[email protected]",
"actid": "GURURAJ",
"uprev": "INVESTOR",
"stat": "Ok"
}
Client Details
Request to be POSTed to uri : /NorenWClientTP/ClientDetails
Request Details :
Parameter Possible value Description
Name
20
jData* Should send json object with fields in below list
Response Details :
actid Account ID
email Email ID
pan PAN
addr Address
addrcity City
addrstate State
21
request_time It will be present only in a successful response.
Request Details :
Parameter Possible value Description
Name
uid* User Id
Response Details :
Response data will be in json format with below fields.
22
Json Fields Possible Description
value
Watch Lists
Get WatchList Names
Request to be POSTed to uri : /NorenWClientTP/MWList
Request Details :
Parameter Possible value Description
Name
23
Response Details :
{
"stat": "Not_Ok",
"emsg": "Session Expired : Invalid Session Key"
}
Get WatchList
Request to be POSTed to uri : /NorenWClientTP/MarketWatch
Request Details :
Parameter Possible value Description
Name
24
jKey* Key Obtained on login success.
Response Details :
pp Price precision
ti Tick size
ls Lot size
25
Sample Success Response :
{
"request_time": "13:25:17 21-05-2020",
"values": [
{
"exch": "BSE",
"token": "972889",
"tsym": "915PTCIF27"
},
{
"exch": "NSE",
"token": "13",
"tsym": "ABB-EQ"
},
{
"exch": "NSE",
"token": "22",
"tsym": "ACC-EQ"
}
],
"stat": "Ok"
}
Sample Failure Response :
{
"stat":"Not_Ok",
"emsg":"Invalid Input : Missing uid or wlname."
}
Search Scrips
Request to be POSTed to uri : /NorenWClientTP/SearchScrip
Request Details :
Parameter Possible value Description
Name
26
uid* Logged in User Id
Response Details :
pp Price precision
ti Tick size
ls Lot size
27
"stat": "Ok",
"values": [
{
"exch": "NSE",
"token": "18069",
"tsym": "REL100NAV-EQ"
},
{
"exch": "NSE",
"token": "24225",
"tsym": "RELAXO-EQ"
},
{
"exch": "NSE",
"token": "4327",
"tsym": "RELAXOFOOT-EQ"
},
{
"exch": "NSE",
"token": "18068",
"tsym": "RELBANKNAV-EQ"
},
{
"exch": "NSE",
"token": "2882",
"tsym": "RELCAPITAL-EQ"
},
{
"exch": "NSE",
"token": "18070",
"tsym": "RELCONSNAV-EQ"
},
{
"exch": "NSE",
"token": "18071",
"tsym": "RELDIVNAV-EQ"
},
{
"exch": "NSE",
"token": "18072",
"tsym": "RELGOLDNAV-EQ"
},
{
28
"exch": "NSE",
"token": "2885",
"tsym": "RELIANCE-EQ"
},
{
"exch": "NSE",
"token": "15068",
"tsym": "RELIGARE-EQ"
},
{
"exch": "NSE",
"token": "553",
"tsym": "RELINFRA-EQ"
},
{
"exch": "NSE",
"token": "18074",
"tsym": "RELNV20NAV-EQ"
}
]
}
Request Details :
Parameter Possible value Description
Name
29
uid* Logged in User Id
Response Details :
Request Details :
Parameter Possible value Description
Name
30
jData* Should send json object with fields in below list
Response Details :
Get SecurityInfo
Request to be POSTed to uri : /NorenWClientTP/GetSecurityInfo
31
Request Details :
Parameter Possible value Description
Name
exch Exchange
Example:
jData={"uid":"{{USER_ID}}", "exch":"NSE",
"token":"22"}&jKey=c180c60ec8f7870490ec27f4accdba179a149a5e5b1d503a0682d8b72acb24
b3
Response Details :
32
seg Segment
isin ISIN
ti Tick Size
ls Lot Size
pp Price precision
mult Multiplier
33
tenstrd Tender Start Date
34
"emsg":"Error Occurred : 5 \"no data\""
}
Get Quotes
Request to be POSTed to uri : /NorenWClientTP/GetQuotes
Request Details :
Parameter Possible value Description
Name
exch Exchange
Example:
jData={"uid":"{{USER_ID}}", "exch":"NSE",
"token":"22"}&jKey=4c258343e010b21851856cadb188e0adc24e173cfbf945e7beda7bc045f745
48
Response Details :
35
exch NSE, BSE, Exchange
NFO ...
seg Segment
isin ISIN
pp Price precision
ls Lot Size
ti Tick Size
mult Multiplier
token Token
lp LTP
o Open Price
v Volume
36
bp1 Best Buy Price 1
37
so2 Best Sell Orders 2
38
"sp2":"0.00",
"bp3":"0.00",
"sp3":"0.00",
"bp4":"0.00",
"sp4":"0.00",
"bp5":"0.00",
"sp5":"0.00",
"bq1":"2",
"sq1":"0",
"bq2":"0",
"sq2":"0",
"bq3":"0",
"sq3":"0",
"bq4":"0",
"sq4":"0",
"bq5":"0",
"sq5":"0",
"bo1":"2",
"so1":"0",
"bo2":"0",
"so2":"0",
"bo3":"0",
"so3":"0",
"bo4":"0",
"so4":"0",
"bo5":"0",
"So5":"0"
}
Request Details :
Parameter Possible value Description
39
Name
Response Details :
Example:
jData={"uid":"{{USER_ID}}"}&jKey=552636ffd5d8f659235e4af6dab0bccdcd5915d26ca07a074a4
912e506ea960f
Request Details :
Parameter Possible value Description
Name
40
jKey* Key Obtained on login success.
Response Details :
pp Price precision
ti Tick size
ls Lot size
Example:
jData={"uid":"{{USER_ID}}","wlname":"NIFTY50"}&jKey=552636ffd5d8f659235e4af6dab0bccdcd
5915d26ca07a074a4912e506ea960f
41
{
"stat": "Ok",
"values": [
{
"exch": "NSE",
"token": "15083",
"tsym": "ADANIPORTS-EQ",
"pp": "2",
"ls": "1",
"ti": "0.05"
},
{
"exch": "NSE",
"token": "236",
"tsym": "ASIANPAINT-EQ",
"pp": "2",
"ls": "1",
"ti": "0.05"
},
{
"exch": "NSE",
"token": "5900",
"tsym": "AXISBANK-EQ",
"pp": "2",
"ls": "1",
"ti": "0.05"
},
{
"exch": "NSE",
"token": "16669",
"tsym": "BAJAJ-AUTO-EQ",
"pp": "2",
"ls": "1",
"ti": "0.05"
},
{
"exch": "NSE",
"token": "16675",
"tsym": "BAJAJFINSV-EQ",
"pp": "2",
"ls": "1",
"ti": "0.05"
},
{
"exch": "NSE",
"token": "317",
"tsym": "BAJFINANCE-EQ",
"pp": "2",
42
"ls": "1",
"ti": "0.05"
},
....
]
}
Request Details :
Parameter Possible value Description
Name
exch* NSE / NFO / BSE Exchange (Select from ‘exarr’ Array provided in User Details
/ MCX response)
dscqty Disclosed quantity (Max 10% for NSE, and 50% for MCX)
prd* C/M/H Product name (Select from ‘prarr’ Array provided in User
Details response, and if same is allowed for selected,
43
exchange. Show product display name, for user to select,
and send corresponding prd in API call)
ret* DAY / EOS / IOC Retention type (Show options as per allowed exchanges)
qty2 Quantity for second leg, mandatory for price type 2L and 3L
prc2 Price for second leg, mandatory for price type 2L and 3L
44
Example:
curl https://apitest.kambala.co.in/NorenWClientTP/PlaceOrder \
-d "jData={\"uid\":\"VIDYA\", \"actid\":\"CLIENT1\", \"exch\":\"NSE\", \"tsym\":\"ACC-EQ\",
\"qty\":\"50\", \"price\":\"1400\", \"prd\":\"H\", \"trantype\":\"B\", \"prctyp\":\"LMT\", \"ret\":\"DAY\"}“ \
-d “jKey=GHUDWU53H32MTHPA536Q32WR”
Response Details :
Modify Order
Request to be POSTed to uri : /NorenWClientTP/ModifyOrder
45
Request Details :
Parameter Possible value Description
Name
exch* Exchange
46
trailprc Trailing Price applicable only if product is selected as H and
B (High Leverage and Bracket order )
Response Details :
Cancel Order
Request to be POSTed to uri : /NorenWClientTP/CancelOrder
Request Details :
Parameter Possible value Description
Name
47
jKey* Key Obtained on login success.
Response Details :
Request Details :
48
Parameter Possible value Description
Name
prd* H/B Allowed for only H and B products (Cover order and bracket
order)
Response Details :
Order Margin
Request to be POSTed to uri : /NorenWClientTP/GetOrderMargin
Request Details :
Parameter Possible value Description
Name
49
jKey* Key Obtained on login success.
exch* NSE / NFO / BSE Exchange (Select from ‘exarr’ Array provided in User Details
/ MCX response)
prd* C/M/H Product name (Select from ‘prarr’ Array provided in User
Details response, and if same is allowed for selected,
exchange. Show product display name, for user to select,
and send corresponding prd in API call)
rorgqty Optional field. Application only for modify order, open order
quantity
rorgprc Optional field. Application only for modify order, open order
price
orgtrgprc Optional field. Application only for modify order, open order
trigger price
50
norenordno Optional field. Application only for H or B order modification
Response Details :
Basket Margin
Request to be POSTed to uri : /NorenWClientTP/GetBasketMargin
Request Details :
Parameter Possible value Description
Name
51
exch* NSE / NFO / BSE Exchange (Select from ‘exarr’ Array provided in User Details
/ MCX response)
prd* C/M/H Product name (Select from ‘prarr’ Array provided in User
Details response, and if same is allowed for selected,
exchange. Show product display name, for user to select,
and send corresponding prd in API call)
rorgqty Optional field. Application only for modify order, open order
quantity
rorgprc Optional field. Application only for modify order, open order
price
orgtrgprc Optional field. Application only for modify order, open order
trigger price
52
Json Fields of Possible value Description
object in values
Array
exch* NSE / NFO / BSE / Exchange (Select from ‘exarr’ Array provided in User
MCX Details response)
Response Details :
53
emsg This will be present only if Order placement fails
Order Book
Request to be POSTed to uri : /NorenWClientTP/OrderBook
Request Details :
Parameter Possible value Description
Name
Example:
curl https://apitest.kambala.co.in/NorenWClientTP/OrderBook \
-d "jData={\"uid\":\"VIDYA\"}“ \
-d “jKey=GHUDWU53H32MTHPA536Q32WR”
Response Details :
Response data will be in json Array of objects with below fields in case of success.
54
prd Display product alias name, using prarr returned in user
details.
uid
actid
amo Yes / No
pp Price precision
ti Tick size
ls Lot size
55
token Contract Token
norentm
ordenttm
exch_tm
snonum This field will be present for product H and B; and only if it
is profit/sl order.
Response data will be in json format with below fields in case of failure:
56
},
{
“stat” : “Ok”,
“exch” : “NSE” ,
“tsym” : “ABB-EQ” ,
“norenordno” : “20062500000002543”,
“prc” : “127830”,
“qty” : “50”,
“prd” : “C”,
“status”: “REJECT”,
“trantype” : “B”,
“prctyp” : ”LMT”,
“fillshares” : “0”,
“avgprc” : “0”,
“rejreason” : “Insufficient funds”
“uid” : “VIDYA”,
“actid” : “CLIENT1”,
“ret” : “DAY”,
“amo” : “No”
}
]
57
Example:
curl https://apitest.kambala.co.in/NorenWClientTP/MultiLegOrderBook \
-d "jData={\"uid\":\"VIDYA\"}“ \
-d “jKey=GHUDWU53H32MTHPA536Q32WR”
Response Details :
Response data will be in json Array of objects with below fields in case of success.
58
dscqty Order disclosed quantity.
uid
actid
amo Yes / No
pp Price precision
ti Tick size
ls Lot size
qty2 Quantity for second leg, mandatory for price type 2L and 3L
prc2 Price for second leg, mandatory for price type 2L and 3L
59
avgprc2 Average trade price of total traded quantity for 2nd leg
avgprc3 Average trade price of total traded quantity for 3rd leg
Response data will be in json format with below fields in case of failure:
● Example:
curl https://apitest.kambala.co.in/NorenWClientTP/SingleOrdHist \
-d "jData={\"uid\":\"VIDYA\"}“ \
-d “jKey=GHUDWU53H32MTHPA536Q32WR”
Response Details :
60
Response data will be in json Array of objects with below fields in case of success.
61
uid
actid
amo Yes / No
pp Price precision
ti Tick size
ls Lot size
norentm
ordenttm
exch_tm
Response data will be in json format with below fields in case of failure:
[
{
"stat": "Ok",
62
"norenordno": "20121300065716",
"uid": "DEMO1",
"actid": "DEMO1",
"exch": "NSE",
"tsym": "ACCELYA-EQ",
"qty": "180",
"trantype": "B",
"prctyp": "LMT",
"ret": "DAY",
"token": "7053",
"pp": "2",
"ls": "1",
"ti": "0.05",
"prc": "800.00",
"avgprc": "800.00",
"dscqty": "0",
"prd": "M",
"status": "COMPLETE",
"rpt": "Fill",
"fillshares": "180",
"norentm": "19:59:32 13-12-2020",
"exch_tm": "00:00:00 01-01-1980",
"remarks": "WC TEST Order",
"exchordid": "6858"
},
{
"stat": "Ok",
"norenordno": "20121300065716",
"uid": "DEMO1",
"actid": "DEMO1",
"exch": "NSE",
"tsym": "ACCELYA-EQ",
"qty": "180",
"trantype": "B",
"prctyp": "LMT",
"ret": "DAY",
"token": "7053",
63
"pp": "2",
"ls": "1",
"ti": "0.05",
"prc": "800.00",
"dscqty": "0",
"prd": "M",
"status": "OPEN",
"rpt": "New",
"norentm": "19:59:32 13-12-2020",
"exch_tm": "00:00:00 01-01-1980",
"remarks": "WC TEST Order",
"exchordid": "6858"
},
{
"stat": "Ok",
"norenordno": "20121300065716",
"uid": "DEMO1",
"actid": "DEMO1",
"exch": "NSE",
"tsym": "ACCELYA-EQ",
"qty": "180",
"trantype": "B",
"prctyp": "LMT",
"ret": "DAY",
"token": "7053",
"pp": "2",
"ls": "1",
"ti": "0.05",
"prc": "800.00",
"dscqty": "0",
"prd": "M",
"status": "PENDING",
"rpt": "PendingNew",
"norentm": "19:59:32 13-12-2020",
"remarks": "WC TEST Order"
},
{
64
"stat": "Ok",
"norenordno": "20121300065716",
"uid": "DEMO1",
"actid": "DEMO1",
"exch": "NSE",
"tsym": "ACCELYA-EQ",
"qty": "180",
"trantype": "B",
"prctyp": "LMT",
"ret": "DAY",
"token": "7053",
"pp": "2",
"ls": "1",
"ti": "0.05",
"prc": "800.00",
"prd": "M",
"status": "PENDING",
"rpt": "NewAck",
"norentm": "19:59:32 13-12-2020",
"remarks": "WC TEST Order"
}
]
Trade Book
Request to be POSTed to uri : /NorenWClientTP/TradeBook
Request Details :
Parameter Possible value Description
Name
65
actid* Account Id of logged in user
Example:
curl https://apitest.kambala.co.in/NorenWClientTP/TradeBook \
-d "jData={\"uid\":\"VIDYA\", \“actid\”:\”DEMO1\”}“ \
-d “jKey=GHUDWU53H32MTHPA536Q32WR”
Response Details :
Response data will be in json Array of objects with below fields in case of success.
uid
actid
66
pp Price precision
ti Tick size
ls Lot size
flid Fill ID
token Token
Response data will be in json format with below fields in case of failure:
[
{
"stat": "Ok",
"norenordno": "20121300065715",
"uid": "GURURAJ",
"actid": "GURURAJ",
"exch": "NSE",
"prctyp": "LMT",
"ret": "DAY",
"prd": "M",
67
"flid": "102",
"fltm": "01-01-1980 00:00:00",
"trantype": "S",
"tsym": "ACCELYA-EQ",
"qty": "180",
"token": "7053",
"fillshares": "180",
"flqty": "180",
"pp": "2",
"ls": "1",
"ti": "0.05",
"prc": "800.00",
"flprc": "800.00",
"norentm": "19:59:32 13-12-2020",
"exch_tm": "00:00:00 01-01-1980",
"remarks": "WC TEST Order",
"exchordid": "6857"
},
{
"stat": "Ok",
"norenordno": "20121300065716",
"uid": "GURURAJ",
"actid": "GURURAJ",
"exch": "NSE",
"prctyp": "LMT",
"ret": "DAY",
"prd": "M",
"flid": "101",
"fltm": "01-01-1980 00:00:00",
"trantype": "B",
"tsym": "ACCELYA-EQ",
"qty": "180",
"token": "7053",
"fillshares": "180",
"flqty": "180",
"pp": "2",
"ls": "1",
68
"ti": "0.05",
"prc": "800.00",
"flprc": "800.00",
"norentm": "19:59:32 13-12-2020",
"exch_tm": "00:00:00 01-01-1980",
"remarks": "WC TEST Order",
"exchordid": "6858"
}
]
Positions Book
Request to be POSTed to uri : /NorenWClientTP/PositionBook
Request Details :
Parameter Possible value Description
Name
Example:
curl https://apitest.kambala.co.in/NorenWClientTP/PositionBook \
-d "jData={\"uid\":\"VIDYA\", \”actid\”:\”ACCT_1\”}“ \
-d “jKey=GHUDWU53H32MTHPA536Q32WR”
Response Details :
Response data will be in json format with Array of Objects with below fields in case of success.
69
value
uid User Id
actid Account Id
lp LTP
rpnl RealizedPNL
70
urmtom UnrealizedMTOM.
(Can be recalculated in LTP update :
= netqty * (lp from web socket - netavgprc) * prcftr
openbuyqty
opensellqty
openbuyamt
opensellamt
openbuyavgprc
opensellavgprc
mult
pp
prcftr gn*pn/(gd*pd).
ti Tick size
ls Lot size
Response data will be in json format with below fields in case of failure:
71
{
"stat":"Ok",
"uid":"POORNA",
"actid":"POORNA",
"exch":"NSE",
"tsym":"ACC-EQ",
"prarr":"C",
"pp":"2",
"ls":"1",
"ti":"5.00",
"mult":"1",
"prcftr":"1.000000",
"daybuyqty":"2",
"daysellqty":"2",
"daybuyamt":"2610.00",
"daybuyavgprc":"1305.00",
"daysellamt":"2610.00",
"daysellavgprc":"1305.00",
"cfbuyqty":"0",
"cfsellqty":"0",
"cfbuyamt":"0.00",
"cfbuyavgprc":"0.00",
"cfsellamt":"0.00",
"cfsellavgprc":"0.00",
"openbuyqty":"0",
"opensellqty":"23",
"openbuyamt":"0.00",
"openbuyavgprc":"0.00",
"opensellamt":"30015.00",
"opensellavgprc":"1305.00",
"netqty":"0",
"netavgprc":"0.00",
"lp":"0.00",
"urmtom":"0.00",
"rpnl":"0.00",
"cforgavgprc":"0.00"
}
]
72
Product Conversion
Request to be POSTed to uri : /NorenWClientTP/ProductConversion
Request Details :
Parameter Possible value Description
Name
exch* Exchange
actid* Account id
Response Details :
73
value
Response Details :
Response data will be in json format with below fields in case of Success:
74
Json Fields Possible Description
value
Exch_tsym object:
Json Fields of Possible Description
object in values value
Array
75
pp Price precision
ti Tick size
ls Lot size
Response data will be in json format with below fields in case of failure:
76
"colqty":"200",
"btstqty":"0",
"btstcolqty":"0",
"usedqty":"0",
"upldprc" : "1400.00"
}
]
Limits
Request to be POSTed to uri : /NorenWClientTP/Limits
Request Details :
Parameter Possible value Description
Name
seg CM / FO / FX Segment
exch Exchange
Response Details :
Response data will be in json format with below fields.
77
stat Ok or Not_Ok Limits request success or failure indication.
actid Account id
seg CM / FO / FX Segment
exch Exchange
-------------------------Margin Utilized----------------------------------
78
premium Premium used
turnoverlmt
pendordvallmt
turnover Turnover
79
uzpnl_e_i Current unrealized MTOM (Equity Intraday)
80
premium_c_i Option premium (Commodity Intraday)
81
c_m
82
"payout":"0.00",
"brkcollamt":"0.00",
"unclearedcash":"0.00",
"daycash":"0.00",
"turnoverlmt":"50000000000000.00",
"pendordvallmt":"2000000000000000.00",
"turnover":"3915000.00",
"pendordval":"2871000.00",
"marginused":"3945540.00",
"mtomcurper":"0.00",
"urmtom":"30540.00",
"grexpo":"3915000.00",
"uzpnl_e_i":"15270.00",
"uzpnl_e_m":"61080.00",
"uzpnl_e_c":"-45810.00"
}
Market Info
Get Index List
Request to be POSTed to uri : /NorenWClientTP/GetIndexList
Request Details :
Parameter Possible value Description
Name
exch* Exchange
83
Response Details :
Sample Output:
{
"request_time": "20:12:29 13-12-2020",
"values": [
{
"idxname": "HangSeng BeES-NAV",
"token": "26016"
},
{
"idxname": "India VIX",
"token": "26017"
},
{
"idxname": "Nifty 50",
"token": "26000"
},
84
{
"idxname": "Nifty IT",
"token": "26008"
},
{
"idxname": "Nifty Next 50",
"token": "26013"
},
{
"idxname": "Nifty Bank",
"token": "26009"
},
{
"idxname": "Nifty 500",
"token": "26004"
},
{
"idxname": "Nifty 100",
"token": "26012"
},
{
"idxname": "Nifty Midcap 50",
"token": "26014"
},
{
"idxname": "Nifty Realty",
"token": "26018"
},
]
}
Request Details :
Parameter Possible value Description
85
Name
exch* Exchange
Response Details :
crt criteria
86
{
"bskt":"NSEBL",
"crt":"LTP"
},
{
"bskt":"NSEBL",
"crt":"VALUE"
},
{
"bskt":"NSEEQ",
"crt":"VOLUME"
},
{
"bskt":"NSEEQ",
"crt":"LTP"
},
{
"bskt":"NSEEQ",
"crt":"VALUE”
},
{
"bskt":"NSEALL",
"crt":"VOLUME"
},
{
"bskt":"NSEALL",
"crt":"LTP"
},
{
"bskt":"NSEALL",
"crt":"VALUE"
}
]
}
87
Parameter Possible value Description
Name
exch* Exchange
crt* criteria
Response Details :
lp LTP
v volume
88
value Total traded value
oi Open interest
89
}
]
}
]
Sample Failure Response :
{
"stat":"Not_Ok",
"emsg":"Invalid Input : Missing uid or exch or bskt or tb or crt"
}
exch* Exchange
token*
Response Details :
90
emsg This will be present only in case of errors.
v volume
oi oi
91
"time":"02-06-2020 15:45:23",
"into":"0.00",
"inth":"0.00",
"intl":"0.00",
"intc":"0.00",
"intvwap":"0.00",
"intv":"0",
"intoi":"0",
"v":"980515",
"oi":"128702"
},
{
"stat":"Ok",
"time":"02-06-2020 15:44:23",
"into":"0.00",
"inth":"0.00",
"intl":"0.00",
"intc":"0.00",
"intvwap":"0.00",
"intv":"0",
"intoi":"0",
"v":"980515",
"oi":"128702"
},
{
"stat":"Ok",
"time":"02-06-2020 15:43:23",
"into":"1287.00",
"inth":"1287.00",
"intl":"0.00",
"intc":"1287.00",
"intvwap":"128702.00",
"intv":"4",
"intoi":"128702",
"v":"980515",
"oi":"128702"
},
{
"stat":"Ok",
"time":"02-06-2020 15:42:23",
"into":"0.00",
"inth":"0.00",
"intl":"0.00",
"intc":"0.00",
"intvwap":"0.00",
"intv":"0",
"intoi":"0",
"v":"980511",
92
"oi":"128702"
}
]
Request Details :
Parameter Possible value Description
Name
cnt* Number of strike to return on one side of the mid price for
PUT and CALL. (example cnt is 4, total 16 contracts will be
returned, if cnt is is 5 total 20 contract will be returned)
Response Details :
93
Json Fields Possible Description
value
pp Price precision
ti Tick size
ls Lot size
Exch Msg
Request to be POSTed to uri : /NorenWClientTP/ExchMsg
Request Details :
Parameter Possible value Description
Name
94
Json Fields Possible value Description
Example:
curl https://apitest.kambala.co.in/NorenWClientTP/ExchMsg \
-d "jData={\"uid\":\"VIDYA\"}“ \
-d “jKey=NSE”
Response Details :
Response data will be in json format with below fields in case of success.
Response data will be in json format with below fields in case of failure:
95
Get Broker Msg
Request to be POSTed to uri : /NorenWClientTP/GetBrokerMsg
Request Details :
Parameter Possible value Description
Name
Response Details :
Response data will be in json format with below fields in case of success.
[
{
"stat": "Ok",
"norentm": "02-05-1975 08:48:52",
"msgtyp": "Admin Message",
"dmsg": "Test Msg All Message Recovery2"
},
{
96
"stat": "Ok",
"norentm": "02-05-1975 08:48:52",
"msgtyp": "Admin Message",
"dmsg": "Test Msg All Message Recovery2"
}
]
Span Calculator
Request to be POSTed to uri : /NorenWClientTP/SpanCalc
Request Details :
Parameter Possible value Description
Name
97
strprc 11900.00, 71.0025 Strike price
Response Details :
Alerts
Set Alert
Request to be POSTed to uri : /NorenWClientTP/SetAlert
Request Details :
Parameter Possible value Description
Name
98
jKey* Key Obtained on login success.
Response Details :
al_id Alert Id
{
"request_time":"11:22:26 08-04-2021",
"stat":"Oi created",
“al_id”:”21040800000004”
}
99
Sample Failure Response :
{
"stat":"Not_Ok",
"emsg":"Session Expired : Invalid Session Key"
}
Cancel Alert
Request to be POSTed to uri : /NorenWClientTP/CancelAlert
Request Details :
Parameter Possible value Description
Name
al_id* Alert Id
Response Details :
al_id Alert Id
100
Sample Success Response :
{
"request_time":"15:03:33 08-04-2021",
"stat":"Oi delete success",
“al_id”:”21040800000008”
}
Modify Alert
Request to be POSTed to uri : /NorenWClientTP/ModifyAlert
Request Details :
Parameter Possible value Description
Name
al_id Alert Id
101
remarks* Any message Entered during order entry.
Response Details :
al_id Alert Id
{
"request_time":"16:36:42 08-04-2021",
"stat":"Oi Replaced",
“al_id”:”21040800000013”
}
Request Details :
Parameter Possible value Description
Name
102
jData* Should send json object with fields in below list
Response Details :
al_id Alert Id
103
“tsym”:”ACC-EQ”,
“exch”:”NSE”
“token”:”22”,
“remarks”:”test”,
“validity”:”DAY”,
“d”:”95000.00”
}
]
Request Details :
Parameter Possible value Description
Name
Response Details :
104
stat Alert order success or failure indication.
{
"stat":"Ok",
"request_time":"04062021121503",
"ai_ts":
[
{"ai_t":"ATP"},
{"ai_t":"LTP"},
{"ai_t":"Perc. Change"}
]
}
Request Details :
Parameter Possible value Description
Name
105
tsym* Trading symbol
ret* DAY / EOS / IOC Retention type (Show options as per allowed exchanges)
dscqty Disclosed quantity (Max 10% for NSE, and 50% for MCX)
Response Details :
al_id Alert Id
106
Sample Success Response :
{
"request_time":"10:02:06 15-04-2021",
"stat":"Oi created",
"Al_id":"21041500000010"
}
Request Details :
Parameter Possible value Description
Name
al_id Alert Id
107
validity* DAY or GTT Validity
ret* DAY / EOS / IOC Retention type (Show options as per allowed exchanges)
dscqty Disclosed quantity (Max 10% for NSE, and 50% for MCX)
Response Details :
al_id Alert Id
{
"request_time":"12:15:18 15-04-2021",
108
"stat":"Oi Replacedt",
"Al_id":"21041500000008"
}
Request Details :
Parameter Possible value Description
Name
al_id* Alert Id
Response Details :
109
al_id Alert Id
{
"request_time":"12:20:01 15-04-2021",
"stat":"Oi delete success",
"Al_id":"21041500000013"
}
Request Details :
Parameter Possible value Description
Name
Response Details :
110
Json Fields Possible Description
value
al_id Alert Id
ret DAY / EOS / Retention type (Show options as per allowed exchanges)
IOC
111
"ai_t":"LTP_A",
"Al_id":"21041500000002",
"tsym":"ACC-EQ",
"exch":"NSE",
"Token":"22",
"Remarks":"test",
"validity":"DAY",
"actid":"MOHINI",
"trantype":"B",
"prctyp":"LMT",
"Qty":1,
"Prc":"1305.00",
"C":"C",
"prd":"C",
"ordersource":"MOB",
"d":"1900.00"
}
]
Request Details :
Parameter Possible value Description
Name
Response Details :
112
Response data will have below fields.
Request Details :
Parameter Possible value Description
Name
113
Json Fields Possible value Description
Response Details :
{
"stat":"Ok",
"Request_time":"10052021152900",
"trd_date":
[
{
"trd_date":"28-04-2021"
},
{
"trd_date":"29-04-2021"
},
{
"trd_date":"30-04-2021"
}
]
}
114
"stat":"Not_Ok",
"emsg":"Session Expired : Invalid Session Key"
}
Funds
Get Max Payout Amount:
Request to be POSTed to uri : /NorenWClientTP/GetMaxPayoutAmount
Request Details :
Parameter Possible value Description
Name
Response Details :
actid Account id
115
payout Maximum payout amount
Request Details :
Parameter Possible value Description
Name
Response Details :
116
Json Fields Possible Description
value
{
"request_time":"18:51:38 25-06-2021",
"stat":"Ok",
"basketlists":
[
{"basket":"NSEEQ"},
{"basket":"BSEEQ"},
{"basket":"A"}
]
}
Request Details :
Parameter Possible value Description
Name
117
Json Fields Possible Description
value
Response Details :
lp LTP
c Close price
h High price
l Low price
v Volume
pc Percentage change
118
Sample Success Response :
[
{
"request_time":"18:51:38 25-06-2021",
"stat":"Ok",
"tsym":"AUROPHARMA-EQ",
"lp":"1450.00",
"c":"0.00",
"h":"0.00",
"l":"0.00",
"ap":"0.00",
"v":"0",
"ltt":"05:30:00",
"Pc":"0.00"
},
{
"request_time":"18:51:38 25-06-2021",
"stat":"Ok",
"tsym":"3IINFOTECH-EQ",
"lp":"1.10",
"c":"0.90",
"h":"1.15",
"l":"1.10",
"ap":"0.98",
"v":"20",
"ltt":"05:31:40",
"Pc":"0.00"
}
]
119
General Guidelines
1) As soon as connection is done, a connection request should be sent with User id and
login session id.
2) All input and output messages will be in json format.
Connect
Request:
Json Fields Possible value Description
uid User ID
actid Account id
Response :
uid User ID
Subscribe Touchline
Request :
120
t t ‘t’ represents touchline task
Number of Acknowledgements for a single subscription will be the same as the number of scrips
mentioned in the key (k) field.
tk 22 Scrip Token
ts Trading Symbol
ti Tick size
ls Lot size
lp LTP
pc Percentage change
v volume
o Open price
h High price
l Low price
c Close price
oi Open interest
121
toi Total open interest for underlying
tk 22 Scrip Token
lp LTP
pc Percentage change
v volume
o Open price
h High price
l Low price
c Close price
oi Open interest
122
sp1 Best Sell Price 1
Unsubscribe Touchline
Request:
Json Fields Possible value Description
Response :
Subscribe Depth
Request :
Number of Acknowledgements for a single subscription will be the same as the number of scrips
mentioned in the key (k) field.
123
Json Fields Possible value Description
tk 22 Scrip Token
lp LTP
pc Percentage change
v volume
o Open price
h High price
l Low price
c Close price
124
bp5 Best Buy Price 5
52h 52 week high low in other exchanges, Life time high low in
mcx
125
52l 52 week high low in other exchanges, Life time high low in
mcx
oi Open interest
tk 22 Scrip Token
lp LTP
pc Percentage change
v volume
o Open price
h High price
l Low price
c Close price
126
bq3 Best Buy Quantity 3
127
so3 Best Sell Orders 3
52h 52 week high low in other exchanges, Life time high low in
mcx
52l 52 week high low in other exchanges, Life time high low in
mcx
oi Open interest
Sample Message :
{
"t": "df",
"e": "NSE",
"tk": "22",
"o": "1166.00",
"h": "1179.00",
"l": "1145.35",
"c": "1152.65",
"ap": "1159.74",
"v": "819881",
"tbq": "120952",
"tsq": "131730",
"bp1": "1156.00",
"sp1": "1156.50",
"bp2": "1155.80",
"sp2": "1156.55",
"bp3": "1155.75",
"sp3": "1156.65",
"bp4": "1155.70",
"sp4": "1156.70",
"bp5": "1155.65",
"sp5": "1156.75",
128
"bq1": "4",
"sq1": "10",
"bq2": "67",
"sq2": "63",
"bq3": "83",
"sq3": "1",
"bq4": "139",
"sq4": "53",
"bq5": "393",
"sq5": "94"
}
Unsubscribe Depth
Request:
Json Fields Possible value Description
Response :
129
Subscribe Order Update
Request :
Subscription Acknowledgement:
uid User Id
actid Account ID
exch Exchange
prd Product
reporttype Order event for which this message is sent out. (Fill,
Rejected, Canceled)
130
trantype Order transaction type, buy or sell
snonum This will be present for child orders in case of cover and
bracket orders, if present needs to be sent during exit
snoordt This will be present for child orders in case of cover and
bracket orders, it will indicate whether the order is profit or
stoploss
blprc This will be present for cover and bracket parent order. This
is the differential stop loss trigger price to be entered.
bpprc This will be present for bracket parent order. This is the
differential profit price to be entered.
trailprc This will be present for cover and bracket parent order. This
is required if trailing ticks is to be enabled.
131
Unsubscribe Order Update
Request:
Json Fields Possible value Description
Response :
Annexure
Alert Type:
LTP > LTP_A depending on scrip 'pp' from search results allow
2/4 precision
LTP < LTP_B depending on scrip 'pp' from search results allow
2/4 precision
Average > ATP_A depending on scrip 'pp' from search results allow
Trade price of 2/4 precision
day
Average < ATP_B depending on scrip 'pp' from search results allow
Trade price of 2/4 precision
132
day
Open Interest > OI_A Non decimal number, allow only for derivative
contracts
Open Interest < OI_B Non decimal number, allow only for derivative
contracts
Total Open > TOI_A Non decimal number, this will work only for NSE
Interest symbols which are FO listed.
Total Open < TOI_B Non decimal number, this will work only for NSE
Interest symbols which are FO listed.
LTP Both > and < LMT_BOS_ depending on scrip 'pp' from search results allow
O 2/4 precision
Note: All alert types with _O appended will work for GTT order types. Example: to set GTT order
when LTP goes above 1,000, set alert type as LTP_A_O
133