Skip to content

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
jData=
{
"uid": "J171"
}
&jKey=33f901a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
 "request_time": "12:34:52 21-05-2020",
 "values": [
 "default",
 "WL"
           ],
 "stat": "Ok"
}
{
 "stat": "Not_Ok",
 "emsg": "Session Expired : Invalid Session Key"
}

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.
jData=
{
"uid": "J171",
"wlname": "1"
}
&jKey=33f901a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
"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)
jData=
{
"uid": "J171",
"stext":"adani",
"exch":"NSE"
}
&jKey=33f901a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
"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
jData=
{
"uid": "J171",
"wlname":"1",
"scrips":"GREENPOWER-EQ"
}
&jKey=33f901a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
"request_time": "12:41:53 24-05-2024",
"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 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
jData=
{
"uid": "J171",
"wlname":"1",
"scrips":"GREENPOWER-EQ"
}
&jKey=33f901a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
"request_time": "12:41:53 24-05-2024",
"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 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
jData=
{
"uid": "J171",
"exch":"NSE",
"token":"17388"
}
&jKey=33f901a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
"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
jData=
{
"uid": "J171",
"exch":"NSE",
"token":"17388"
}
&jKey=33f901a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
"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
jData=
{
"uid": "J171"
}
&jKey=33f901a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
"values":
"NIFTYBANK",
"NIFTY50"
}
{
 "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
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
jData=
{
"uid": "J171",
"wlname":"NIFTY50"
}
&jKey=33f901a267c4f1a00294e7700dc578bdd42c686f4d25efd6b06eec766f0d80f7
{
    "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