Watch List
Watch Lists
Get WatchList Names
Request Details :
Parameter Name
Possiblevalue
Description
jData*
Should send json object with fields in below list
jKey*
Key Obtained on login success.
Json Fields
Possiblevalue
Description
uid*
Logged in User Id
Get WatchList
Request Details :
Parameter Name
Possiblevalue
Description
jData*
Should send json object with fields in below list
jKey*
Key Obtained on login success.
Json Fields
Possiblevalue
Description
uid*
Logged in User Id
wlname*
Name of the Watchlist, for which scrip list is required.
Request structure: Success Response: Failure Response :
jData =
{
"uid" : "J171" ,
"wlname" : "1"
}
& jKey = 33f 901 a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
"request_time" : "09:38:20 18-05-2024" ,
"values" : [
{
"exch" : "NFO" ,
"token" : "46930" ,
"tsym" : "NIFTY30MAY24F" ,
"dname" : "NIFTY MAY FUT" ,
"pp" : "2" ,
"ls" : "25" ,
"ti" : "0.05" ,
"optt" : "XX" ,
"instname" : "FUTIDX"
},
{
"exch" : "NSE" ,
"token" : "1348" ,
"tsym" : "HEROMOTOCO-EQ" ,
"pp" : "2" ,
"ls" : "1" ,
"ti" : "0.05" ,
"instname" : "EQ"
},
{
"exch" : "NSE" ,
"token" : "3499" ,
"tsym" : "TATASTEEL-EQ" ,
"pp" : "2" ,
"ls" : "1" ,
"ti" : "0.05" ,
"instname" : "EQ"
},
{
"exch" : "NSE" ,
"token" : "9380" ,
"tsym" : "IL&FSENGG-BZ" ,
"pp" : "2" ,
"ls" : "1" ,
"ti" : "0.05" ,
"instname" : "BZ"
},
],
"stat" : "Ok"
}
{
"stat" : "Not_Ok" ,
"emsg" : "Session Expired : Invalid Session Key"
}
Response Details :
Response data will be in json format with below fields.
Json Fields
Possiblevalue
Description
stat
Ok or Not_Ok
MWList success or failure indication.
values
Array of json objects. (object fields given in below table)
request_time
It will be present only in a successful response.
emsg
This will be present only in case of errors.That is : 1) Invalid Input : Invalid Watch List Name 2) Session Expired
Json Fields of object in values Array
Possiblevalue
Description
exch
NSE, BSE, NFO ...
Exchange
tsym
Trading symbol of the scrip (contract)
token
Token of the scrip (contract)
pp
Price precision
ti
Tick size
ls
Lot size
dname
Broker specific contract display name, present only if applicable.
Search Scrips
Request Details :
Parameter Name
Possiblevalue
Description
jData*
Should send json object with fields in below list
jKey*
Key Obtained on login success
Json Fields
Possiblevalue
Description
uid*
Logged in User Id
stext*
Search Text
exch
Exchange (Select from ‘exarr’ Array provided in User Details response)
Request structure: Success Response: Failure Response :
jData =
{
"uid" : "J171" ,
"stext" : "adani" ,
"exch" : "NSE"
}
& jKey = 33f 901 a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
"stat" : "Ok" ,
"values" : [
{
"exch" : "NSE" ,
"token" : "17388" ,
"tsym" : "ADANIPOWER-EQ" ,
"cname" : "ADANI POWER LTD" ,
"instname" : "EQ" ,
"pp" : "2" ,
"ls" : "1" ,
"ti" : "0.05"
},
{
"exch" : "NSE" ,
"token" : "15083" ,
"tsym" : "ADANIPORTS-EQ" ,
"cname" : "ADANI PORT & SEZ LTD" ,
"instname" : "EQ" ,
"pp" : "2" ,
"ls" : "1" ,
"ti" : "0.05"
},
{
"exch" : "NSE" ,
"token" : "3563" ,
"tsym" : "ADANIGREEN-EQ" ,
"cname" : "ADANI GREEN ENERGY LTD" ,
"instname" : "EQ" ,
"pp" : "2" ,
"ls" : "1" ,
"ti" : "0.05"
},
{
"exch" : "NSE" ,
"token" : "25" ,
"tsym" : "ADANIENT-EQ" ,
"cname" : "ADANI ENTERPRISES LIMITED" ,
"instname" : "EQ" ,
"pp" : "2" ,
"ls" : "1" ,
"ti" : "0.05"
},
{
"exch" : "NSE" ,
"token" : "10217" ,
"tsym" : "ADANIENSOL-EQ" ,
"cname" : "ADANI ENERGY SOLUTION LTD" ,
"instname" : "EQ" ,
"pp" : "2" ,
"ls" : "1" ,
"ti" : "0.05"
}
]
}
{
"stat" : "Not_Ok" ,
"emsg" : "Session Expired : Invalid Session Key"
}
Response Details :
Response data will be in json format with below fields.
Json Fields
Possiblevalue
Description
stat
Ok or Not_Ok
Market watch success or failure indication.
values
Array of json objects. (object fields given in below table)
emsg
This will be present only in case of errors. That is : 1) Invalid Input 2) Session Expired
Json Fields of object in values Array
Possiblevalue
Description
exch
NSE, BSE, NFO ...
Exchange
tsym
Trading symbol of the scrip (contract)
token
Token of the scrip (contract)
pp
Price precision
ti
Tick size
ls
Lot size
weekly
Weekly Option, ‘W1’, ‘W2’, ‘W3’, ‘W4’ th week
nontrd
Non tradable instruments
Add Scrip to Watch List
Request Details :
Parameter Name
Possiblevalue
Description
jData*
Should send json object with fields in below list
jKey*
Key Obtained on login success.
Json Fields
Possiblevalue
Description
uid*
Logged in User Id
wlname*
Name of the Watchlist, for which scrip list is required.
scrips*
List of scrips, example format NSE
Response Details :
Response data will be in json format with below fields.
Json Fields
Possiblevalue
Description
stat
Ok or Not_Ok
Watch list update success or failure indication.
request_time
It will be present only in a successful response.
emsg
This will be present only in case of errors. That is : 1 Invalid Input, 2 : Session Expired
Delete Scrip to Watch List
Request Details
Parameter Name
Possiblevalue
Description
jData*
Should send json object with fields in below list
jKey*
Key Obtained on login success.
Json Fields
Possiblevalue
Description
uid*
Logged in User Id
wlname*
Name of the Watchlist, for which scrip list is required.
scrips*
List of scrips, example format NSE
Response Details :
Response data will be in json format with below fields.
Json Fields
Possiblevalue
Description
stat
Ok or Not_Ok
Watch list update success or failure indication.
request_time
It will be present only in a successful response.
emsg
This will be present only in case of errors.That is : 1) Invalid Input 2) Session Expired
Get SecurityInfo
Request Details :
Parameter Name
Possiblevalue
Description
jData*
Should send json object with fields in below list
jKey*
Key Obtained on login success.
Json Fields
Possiblevalue
Description
uid*
Logged in User Id
exch
Exchange
token
Contract Token
Request structure: Success Response: Failure Response :
jData =
{
"uid" : "J171" ,
"exch" : "NSE" ,
"token" : "17388"
}
& jKey = 33f 901 a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
"request_time" : "12:55:38 24-05-2024" ,
"stat" : "Ok" ,
"exch" : "NSE" ,
"tsym" : "ADANIPOWER-EQ" ,
"cname" : "ADANI POWER LTD" ,
"symname" : "ADANIPOWER" ,
"seg" : "EQT" ,
"instname" : "EQ" ,
"isin" : "INE814H01011" ,
"pp" : "2" ,
"prcftr" : "1.000000" ,
"ls" : "1" ,
"ti" : "0.05" ,
"mult" : "1" ,
"issue_d" : "20-08-2009" ,
"listing_d" : "20-08-2009" ,
"uc" : "853.60" ,
"lc" : "569.10" ,
"prcftr_d" : "(1 / 1 ) * (1 / 1)" ,
"token" : "17388" ,
"frzqty" : "138849" ,
"delmrg" : "60.00" ,
"varmrg" : "20.00" ,
"elmmrg" : "0.00"
}
{
"stat" : "Not_Ok" ,
"emsg" : "Session Expired : Invalid Session Key"
}
Response Details :
Response data will have below fields.
Json Fields
Possiblevalue
Description
request_time
It will be present only in a successful response.
stat
Ok or Not_Ok
Market watch success or failure indication.
exch
NSE, BSE,NFO ...
Exchange
tsym
Trading Symbol
cname
Company Name
symnam
Symbol Name
seg
Segment
exd
Expiry Date
instname
Intrument Name
strprc
Strike Price
optt
Option Type
isin
ISIN
ti
Tick Size
ls
Lot Size
pp
Price precision
mult
Multiplier
gp_nd
gn/gd * pn/pd (text format)
prcunt
Price Units
prcqqty
Price Quote Qty
trdunt
Trade Units
delunt
Delivery Units
frzqty
Freeze Qty
gsmind
scripupdate Gsm Ind
elmbmrg
Elm Buy Margin
elmsmrg
Elm Sell Margin
addbmrg
Additional Long Margin
addsmrg
Additional Short Margin
splbmrg
Special Long Margin
splsmrg
Special Short Margin
delmrg
Delivery Margin
tenmrg
Tender Margin
tenstrd
Tender Start Date
tenendd
Tender End Eate
exestrd
Exercise Start Date
exeendd
Exercise End Date
mkt_t
Market type
issue_d
Issue date
listing_d
Listing date
last_trd_d
last trading date
elmmrg
Elm Margin
varmrg
Var Margin
expmrg
Exposure Margin
token
Contract Token
prcftr_d
((GN / GD) * (PN/PD)) (actual value for calculations)
weekly
Weekly Option, ‘W1’, ‘W2’, ‘W3’, ‘W4’ th week
nontrd
Non tradable instruments
dname
Broker specific contract display name, present only if applicable.
uc
Upper circuit limitlc
lc
Lower circuit limit
Get Quotes
Request Details :
Parameter Name
Possiblevalue
Description
jData*
Should send json object with fields in below list
jKey*
Key Obtained on login success.
Json Fields of object in values Array
Possiblevalue
Description
uid*
Logged in User Id
exch
Exchange
token
Contract Token
Request structure: Success Response: Failure Response :
jData =
{
"uid" : "J171" ,
"exch" : "NSE" ,
"token" : "17388"
}
& jKey = 33f 901 a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
"request_time" : "13:02:50 24-05-2024" ,
"stat" : "Ok" ,
"exch" : "NSE" ,
"tsym" : "ADANIPOWER-EQ" ,
"cname" : "ADANI POWER LTD" ,
"symname" : "ADANIPOWER" ,
"seg" : "EQT" ,
"instname" : "EQ" ,
"isin" : "INE814H01011" ,
"pp" : "2" ,
"ls" : "1" ,
"ti" : "0.05" ,
"mult" : "1" ,
"lut" : "1716535968" ,
"uc" : "853.60" ,
"lc" : "569.10" ,
"wk52_h" : "720.50" ,
"wk52_l" : "231.00" ,
"prcftr_d" : "(1 / 1 ) * (1 / 1)" ,
"token" : "17388" ,
"lp" : "714.60" ,
"c" : "711.35" ,
"h" : "720.20" ,
"l" : "703.00" ,
"ap" : "713.67" ,
"o" : "713.50" ,
"v" : "3564436" ,
"ltq" : "65" ,
"ltt" : "13:02:47" ,
"ltd" : "24-05-2024" ,
"tbq" : "300251" ,
"tsq" : "761392" ,
"bp1" : "714.60" ,
"sp1" : "714.85" ,
"bp2" : "714.55" ,
"sp2" : "714.90" ,
"bp3" : "714.45" ,
"sp3" : "714.95" ,
"bp4" : "714.40" ,
"sp4" : "715.00" ,
"bp5" : "714.35" ,
"sp5" : "715.05" ,
"bq1" : "24" ,
"sq1" : "1937" ,
"bq2" : "318" ,
"sq2" : "216" ,
"bq3" : "64" ,
"sq3" : "1022" ,
"bq4" : "188" ,
"sq4" : "4649" ,
"bq5" : "95" ,
"sq5" : "105" ,
"bo1" : "1" ,
"so1" : "3" ,
"bo2" : "2" ,
"so2" : "2" ,
"bo3" : "2" ,
"so3" : "4" ,
"bo4" : "6" ,
"so4" : "29" ,
"bo5" : "2" ,
"so5" : "2"
}
{
"stat" : "Not_Ok" ,
"emsg" : "Session Expired : Invalid Session Key"
}
Response Details :
Response data will be in json format with below fields.
Json Fields of object in values Array
Possiblevalue
Description
value
stat
Ok or Not_Ok
Watch list update success or failure indication.
request_time
It will be present only in a successful response.
exch
NSE, BSE, NFO ...
Exchange
tsym
Trading Symbol
cname
Company Name
symname
Symbol Name
seg
Segment
instname
Instrument Name
isin
ISIN
pp
Price precision
ls
Lot Size
ti
Tick Size
mult
Multiplier
uc
Upper circuit limitlc
lc
Lower circuit limit
prcftr_d
token
Token
lp
LTP
o
Open Price
c
Close Price
h
Day High Price
l
Day Low Price
v
Volume
ap
Average trade price or VWAP for day
ltq
Last trade quantity
ltt
Last trade time
ltd
dd-mm-yy Last Trade Date
bp1
Best Buy Price 1
sp1
Best Sell Price 1
bp2
Best Buy Price 2
sp2
Best Sell Price 2
bp3
Best Buy Price 3
sp3
Best Sell Price 3
bp4
Best Buy Price 4
sp4
Best Sell Price 4
bp5
Best Buy Price 5
sp5
Best Sell Price 5
bq1
Best Buy Quantity 1
sq1
Best Sell Quantity 1
bq2
Best Buy Quantity 2
sq2
Best Sell Quantity 2
bq3
Best Buy Quantity 3
sq3
Best Sell Quantity 3
bq4
Best Buy Quantity 4
sq4
Best Sell Quantity 4
bq5
Best Buy Quantity 5
sq5
Best Sell Quantity 5
bo1
Best Buy Orders 1
so1
Best Sell Orders 1
bo2
Best Buy Orders 2
so2
Best Sell Orders 2
bo3
Best Buy Orders 3
so3
Best Sell Orders 3
bo4
Best Buy Orders 4
so4
Best Sell Orders 4
bo5
Best Buy Orders 5
so5
Best Sell Orders 5
und_exch
Underlying Exch seg
und_tk
Underlying Token
Get list of predefined MWs
Request Details :
Parameter Name
Possiblevalue
Description
jData*
Should send json object with fields in below list
jKey*
Key Obtained on login success
Json Fields of object in values Array
Possiblevalue
Description
uid*
Logged in User Id
Response Details :
Response data will be in json format with below fields.
Json Fields
Possiblevalue
Description
values
Watch List names as a json array of strings
Get list of predefined MW scrips
Request Details :
Parameter Name
Possiblevalue
Description
jData*
Should send json object with fields in below list
jKey*
Key Obtained on login success
Json Fields
Possiblevalue
Description
uid*
Logged in User Id
wlname*
Name of the Watchlist, for which scrip list is required
Request structure: Success Response: Failure Response :
jData =
{
"uid" : "J171" ,
"wlname" : "NIFTY50"
}
& jKey = 33f 901 a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
"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" ,
"ls" : "1" ,
"ti" : "0.05"
},
....
]
}
{
"stat" : "Not_Ok" ,
"emsg" : "Session Expired : Invalid Session Key"
}
Response Details :
Response data will be in json format with below fields.
Json Fields
Possiblevalue
Description
stat
Ok or Not_Ok
Market watch success or failure indication.
values
Array of json objects. (object fields given in below table)
Json Fields of object in values Array
Possiblevalue
Description
exch
NSE, BSE, NFO ...
Exchange
tsym
Trading symbol of the scrip (contract)
token
Token of the scrip (contract)
pp
Price precision
ti
Tick size
ls
Lot size