Skip to content

Order Updates Fail-over Reporting

This API is used to get the ORDER_UPDATE transactions done by a user when a vendor is down and the user tries to transact. The users need to provide a date range to retrieve updates of transaction.

Method GET
URL <-baseUrl->/edelmw-eq/eq/order/orders/order-updates?pageNo=0&pageSize=2&from=2020-02-18 00:00:00&to=2020-02-24 23:00:00
Method GET

HEADERS

Key Value
Content-Type application/json
Source <-Vendor Name->
SourceToken <-SourceToken value->

Request Parameters

Key Value Description Mandatory?
PageNo zero onwards {0,1,2 and so on..} The requested document in its entirety is divided into discrete pages. The numeric values are indices to these pages. A pageNo=0 would mean the very first slice/page of the requested document that would come in response. YES
pageSize 1 onwards. Specifies how many records per page should be returned YES
from Start date for request range A valid date in the format mentioned YES
to End date for request range A valid date in format mentioned. If not specified, records retrieved shall be later than the from date specified. NO

Note:- When from date and to date in the request parameters are specified, the range should not exceed 30 days.

Sample Request
Request method is GET
https://np.nuvamawealth.com/edelmw-eq/eq/order/orders/order-updates?pageNo=0&pageSize=2&from=2020-02-18 00:00:00&to=2020-02-24 23:00:00

Header

Key Value
Source <-Source Vendor->
SourceToken <-Source token value->

Response Parameters

Parameter Description
type "Type of update TRADE_UPDATE - for trade update packets ORDER_UPDATE - for order update packets"
accId Account ID
accTyp "Asset Type: EQUITY, COMMODITY"
desc "Description of transaction ex ""Buy 1 Qty @ ₹ 284.85"""
dpName Company Name of the Stock
chg Change price of stock
chgP Change % of stock 
dExpDt   Display Expiry Date
dInsTyp  Display Instrument Type
dpName Display Name
exONo Exchange Order Number
exc "Exchange Segment NSE/BSE/CDS/NFO/BFO"
fID Fill ID (when order gets traded)
fPrc Fill Price
fQty Fill Quantity - Traded Quantity
lsz Lot Size
ltp Last Traded Price 
oID NEST Order Number
oTyp "Type of Order LIMIT , STOP LOSS, MARKET, STOP LOSS - MARKET"
opTyp "Option Type PUT,CALL "
pCode "Product Type CNC, NRML, MTF, MIS,CO, BO"
pConv Position Conversion flag
qty Quantity
rcvTim Received Time
srs Series - EQ/BE
stkPrc Strike Price 
sts Status of Trade
sym scrip on which trade happened
tPrc Total Price
tSym Trade Symbol
tTyp "Transaction Type BUY , SELL"
tsz Tick Size
userID User ID
extOrdTim Trade Time in epoch
syomId Will be same as nest order id  when order is traded
vlDt Order/Trade Validity date 
usrCmnt User Comment
rcvDt Receive Date
rmk Remarks from User 
boSeqId Bracket Order Sequence ID (to map different legs of Bracket Order) 
ordTim Date + Time
nReqID NEST Request ID
vndSrc Source vendor
vndLst List of vendors to which user has given consent
vndAcOp Vendor Account opening source
ogt Order Generation Type
trgPrc Target Price
isTgt Is Target Hit
isSL Is Stop Loss enabled
exit NA
dur validity - DAY, IOC, EOS,GTC GTD
isCOSecLeg "cover order second leg flag FALSE"
edit NA
exit NA
app NA
info NA
Sample Response


    "config": {},
    "data": {
        "type": "vendorOrderRespObject",
        "list": [
            {
                "accId": "EB003311",
                "accTyp": "EQ",
                "crdt": "2020-02-24 21:10:03",
                "data": {
                    "avgPrc": "0.00",
                    "boSeqId": "",
                    "cancel": "true",
                    "desc": "Buy 1 Qty @ &#8377 284.85",
                    "dpName": "TATASTEEL",
                    "dur": "DAY",
                    "edit": "true",
                    "exONo": "1000000000000237",
                    "exc": "NSE",
                    "exit": "false",
                    "extOrdTim": "1586768646096151",
                    "isCOSecLeg": "false",
                    "isSL": false,
                    "isTgt": false,
                    "lsz": "1",
                    "ogt": "AMO",
                    "opTyp": "",
                    "ordTim": "12/04/2020 15:48:00",
                    "prc": "284.85",
                    "rcvDt": "12/04/2020",
                    "rcvTim": "15:48:00",
                    "rmk": "",
                    "srs": "EQ",
                    "stkPrc": "",
                    "sts": "after market order req received",
                    "sym": "3499_NSE",
                    "syomId": "NA",
                    "trgPrc": "0.00",
                    "tsz": "0.05",
                    "userID": "MEHJAI11",
                    "usrCmnt": "",
                    "vlDt": "",
                    "vndAcOp": "",
                    "vndLst": [
                        "TESTVENDOR12",
                        "TESTVENDOR11",
                        "TESTVENDOR10",
                        "TESTVENDOR06"
                    ],
                    "vndSrc": "TESTVENDOR06"
                },
                "type": "ORDER_UPDATE",
                "usrId": "MEHJAI11"
            }

        ],
        "sts": false
    },
    "msgID": "381f283d-1ad6-4f25-a976-82202f130ec2",
    "srvTm": 1589220077980
}

Pay-In Payment Fail-over API

This API provides the list of transactions for a given date range for all the vendors to which users have given consent.

Method GET
URL <-baseUrl->/edelmw-eq/eq/fund/history/transactions/PAYIN?from=2020-04-11 00:00:00&to=2020-05-05 23:00:00
Method GET
HEADERS
Key Value
Content-Type application/json
Source <-Vendor Name->
SourceToken <-Source token value->

Note: Adhere to the date format as shown above in the request for 'from' and 'to'.

Request Parameters

from Start date for request range A valid date in the format mentioned YES
to End date for request range A valid date in format mentioned. If not specified, records retrieved shall be later than the from date specified. YES

Note:- When from date and to date in the request parameters are specified, the range should not exceed 30 days.

Sample Request
Request method is GET
https://np.nuvamawealth.com/edelmw-eq/eq/fund/history/transactions/PAYIN?from=2020-04-11 00:00:00&to=2020-05-05 23:00:00

Header

Key Value
Source <-Source Vendor->
SourceToken <-Source token value->

Response Parameters

Parameter Description
BName Bank name
RTyp "Request type. PAYIN or PAYOUT"
TAmt total amount
accCode Account code
accountno Account number
createddate date of payin/payout
refNo Reference Number
recordsFetchedTill This field has the date which lies in between from and to. It has to be passed as from in the subsequent requests
app NA
info NA
Sample Response
{

    "config": {},
    "data": {
        "type": "transactionHistoryRespDao",
        "list": [
            {
                "BName": "ICICI BANK LTD",
                "INo": "EDEL_EQ_00000011245",
                "RTyp": "payin",
                "TAmt": "59",
                "accCode": "EB003311",
                "accountno": "104301500918",
                "cancel": false,
                "createddate": "2020-04-10T20:17:47.667084",
                "dt": "10 Apr 2020",
                "edit": false,
                "isprimary": false,
                "ledgername": "Normal",
                "paymode": "UPI",
                "refNo": "16718162D3DA467",
                "rmk": "In Process",
                "seg": "EQ",
                "sts": "In Process",
                "tm": "8:17 PM",
                "txnEpoch": 1.586549867667084E12,
                "updateddate": "2020-04-10T20:17:49.574288",
                "upi": ""
            },
            {
                "BName": "YES Bank",
                "INo": "EDEL_EQ_00000011246",
                "RTyp": "payin",
                "TAmt": "50",
                "accCode": "EB003311",
                "accountno": "008291700000370",
                "cancel": false,
                "createddate": "2020-04-13T10:30:50.879199",
                "dt": "13 Apr 2020",
                "edit": false,
                "isprimary": false,
                "ledgername": "Normal",
                "paymode": "Internet Banking",
                "refNo": "700004977606",
                "rmk": "Processed",
                "seg": "EQ",
                "sts": "Processed",
                "tm": "10:30 AM",
                "txnEpoch": 1.586773850879199E12,
                "updateddate": "2020-04-13T10:35:42.351063",
                "upi": ""
            },
            {
                "BName": "ICICI BANK LTD",
                "INo": "EDEL_EQ_00000011256",
                "RTyp": "payin",
                "TAmt": "50",
                "accCode": "EB003311",
                "accountno": "104301500918",
                "cancel": false,
                "createddate": "2020-04-14T11:12:16.317827",
                "dt": "14 Apr 2020",
                "edit": false,
                "isprimary": false,
                "ledgername": "Normal",
                "paymode": "Internet Banking",
                "refNo": "28B83A05792C4AE",
                "rmk": "Failed",
                "seg": "EQ",
                "sts": "Failed",
                "tm": "11:12 AM",
                "txnEpoch": 1.5868627363178271E12,
                "updateddate": "2020-04-14T11:12:16.317827",
                "upi": ""
            }

        ],
        "recordsFetchedTill": "2020-05-05T18:26:20+05:30"
    },
    "msgID": "843a6c8a-6383-41a2-8c71-a1874492f7d4",
    "srvTm": 1589225309214
}

Note:- The 'recordsFetchedTill' field from the response should be picked and sent in as 'from' request parameter for the subsequent request and 'to' request parameter remains the same as original request.

Trade Updates Fail-over Reporting

This API is used to get the TRADE_UPDATE transactions done by a user when a vendor is down and the user tries to transact. The users need to provide a date range to retrieve updates of transaction.

Method GET
URL /edelmw-eq/eq/order/orders/trade-updates?pageNo=0&pageSize=2&from=2020-02-18 00:00:00&to=2020-02-24 23:00:00
Method GET

HEADERS

Key Value
Content-Type application/json
Source <-Vendor Name->
SourceToken <-SourceToken value->

Note: Adhere to the date format as shown above in the request for 'from' and 'to'.

Request Parameters

Key Value Description Mandatory?
PageNo zero onwards {0,1,2 and so on..} The requested document in its entirety is divided into discrete pages. The numeric values are indices to these pages. A pageNo=0 would mean the very first slice/page of the requested document that would come in response. YES
pageSize 1 onwards. Specifies how many records per page should be returned YES
from Start date for request range A valid date in the format mentioned YES
to End date for request range A valid date in format mentioned. If not specified, records retrieved shall be later than the from date specified. NO

Note:- When from date and to date in the request parameters are specified, the range should not exceed 30 days.

Sample Request
Request method is GET
https://np.nuvamawealth.com/edelmw-eq/eq/order/orders/trade-updates?pageNo=0&pageSize=2&from=2020-02-18 00:00:00&to=2020-02-24 23:00:00

Header

Key Value
Source <-Source Vendor->
SourceToken <-Source token value->

Response Parameters

Parameter Description
type "Type of update TRADE_UPDATE - for trade update packets ORDER_UPDATE - for order update packets"
accId Account ID
accTyp "Asset Type: EQUITY COMMODITY"
desc "Description of transaction ex ""Buy 1 Qty @ ₹ 284.85"""
dpName Company Name of the Stock
chg Change price of stock
chgP Change % of stock 
dExpDt  Display Expiry Date
dInsTyp  Display Instrument Type
dpName Display Name
exONo Exchange Order Number
exc "Exchange Segment NSE/BSE/CDS/NFO/BFO"
fID Fill ID (when order gets traded)
fPrc Fill Price
fQty Fill Quantity - Traded Quantity
lsz Lot Size
ltp Last Traded Price 
oID NEST Order Number
oTyp "Type of Order LIMIT , STOP LOSS , MARKET , STOP LOSS - MARKET"
opTyp "Option Type PUT ,CALL "
pCode "Product Type CNC , NRML, MTF , MIS, CO,BO"
pConv Position Conversion flag
qty Quantity
rcvTim Received Time
srs Series - EQ/BE
stkPrc Strike Price 
sts Status of Trade
sym NA
tPrc Total Price
tSym Trade Symbol
tTyp "Transaction Type BUY, SELL"
tsz Tick Size
userID User ID
extOrdTim Trade Time in epoch
syomId Will be same as nest order id  when order is traded
vlDt Order/Trade Validity date 
usrCmnt User Comment
rcvDt Receive Date
rmk Remarks from User 
boSeqId Bracket Order Sequence ID (to map different legs of Bracket Order) 
ordTim Date + Time
nReqID NEST Request ID
vndSrc Source vendor
vndLst List of vendors to which user has given consent
vndAcOp Vendor Account opening source
ogt Order Generation Type
trgPrc Target Price
isTgt Is Target Hit
isSL Is Stop Loss enabled
exit NA
dur validity - DAY, IOC, EOS,GTC GTD
isCOSecLeg "cover order second leg flag FALSE"
edit NA
exit NA
app NA
info NA
Sample Response
{

    "config": {},
    "data": {
        "type": "vendorTradeRespObject",
        "list": [
            {
                "accId": "EB003311",
                "accTyp": "EQ",
                "crdt": "2020-02-24 21:10:03",
                "data": {
                    "avgPrc": "0.00",
                    "boSeqId": "",
                    "cancel": "true",
                    "desc": "Buy 1 Qty @ &#8377 284.85",
                    "dpName": "TATASTEEL",
                    "dur": "DAY",
                    "edit": "true",
                    "exONo": "1000000000000237",
                    "exc": "NSE",
                    "exit": "false",
                    "extOrdTim": "1586768646096151",
                    "isCOSecLeg": "false",
                    "isSL": false,
                    "isTgt": false,
                    "lsz": "1",
                    "ogt": "AMO",
                    "opTyp": "",
                    "ordTim": "12/04/2020 15:48:00",
                    "prc": "284.85",
                    "rcvDt": "12/04/2020",
                    "rcvTim": "15:48:00",
                    "rmk": "",
                    "srs": "EQ",
                    "stkPrc": "",
                    "sts": "after market order req received",
                    "sym": "3499_NSE",
                    "syomId": "NA",
                    "trgPrc": "0.00",
                    "tsz": "0.05",
                    "userID": "MEHJAI11",
                    "usrCmnt": "",
                    "vlDt": "",
                    "vndAcOp": "",
                    "vndLst": [
                        "TESTVENDOR12",
                        "TESTVENDOR11",
                        "TESTVENDOR10",
                        "TESTVENDOR06"
                    ],
                    "vndSrc": "TESTVENDOR06"
                },
                "type": "TRADE_UPDATE",
                "usrId": "MEHJAI11"
            }

        ],
        "sts": false
    },
    "msgID": "381f283d-1ad6-4f25-a976-82202f130ec2",
    "srvTm": 1589220077980
}