Get Commission & VAT

POST 
/v1.2/order/commission-vat

deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

Please use Estimate Order Charges instead.

This is used to get the tentative commission and VAT for a particular buy or sell order before submission. This tentative values and actual values after the trade is completed can be slightly different.

quantity or orderValue is required. if quantity > 0, order will place using quantity not orderValue.

same equity instrument types will be added for SPOT orders as well.

If the order type is Market (1) or Limit (2), the price field is required to be sent.

to get BOND commission and vat, use amount instead of quantity.

Field Name	Equity	Option	Fixed Income	Fund	Spot
accountNumber	required	required	required	required	required
symbol	required	required	required	required	required
exchange	required	required	required	required	required
quantity	optional	optional	N/A	N/A	optional
orderType	required	required	required	N/A	required
price	required	required	required	N/A	required
tradingSession	optional	N/A	N/A	N/A	optional
orderValue	optional	N/A	N/A	N/A	optional
securityType	optional	optional	optional	optional	optional
instrumentType	optional	optional	optional	optional	optional
amount	N/A	N/A	required	required	N/A

asset	security type	instrument type
equity	CS	0,60,61,86
option	OPT	10
fixed income	BND	75
mutual fund	FND	2

Request

Header Parameters

Throttle-Key string

application/json

Body

accountNumber string

Security account number

price number
quantity number
amount number
exchange string
symbol string
tradingSession string

Default value: REG

For trading Sessions - Master data > Get Support Trading Sessions

orderType integerdeprecated

For Order types - Master Data > Get Exchange Order Types

securityType string

Possible values: [CS, OPT, BND, FND]

CS(Equity), OPT(Option), BND(Fixed Income), FND(Mutual Fund)

orderValue number
instrumentType string

Responses

200

OK

application/json

Schema

Schema

status stringrequired
reason stringrequired
rejectCode integerrequired

Find error codes here

commission numberrequired
vat numberrequired

Example (from schema)

{
  "status": "string",
  "reason": "string",
  "rejectCode": 0,
  "commission": 0,
  "vat": 0
}

example

{
  "status": "SUCCESS",
  "reason": "commission and vat retrieved",
  "rejectCode": 0,
  "commission": 5,
  "vat": 1
}

401

Unauthorized

application/json

Schema

Schema

timestamp string
status stringrequired
error stringrequired
message string
path string
rejectCode stringrequired

Example (from schema)

{
  "timestamp": "string",
  "status": "string",
  "error": "string",
  "message": "string",
  "path": "string",
  "rejectCode": "string"
}

Invalid Token

{
  "timestamp": "2023-12-28T09:51:50.682Z",
  "status": "401",
  "error": "Unauthorized",
  "message": "Invalid Token",
  "path": "/api/v1.2/commission",
  "rejectCode": "1008"
}

Expired Token

{
  "timestamp": "2023-12-28T09:51:50.682Z",
  "status": "401",
  "error": "Unauthorized",
  "message": "Expired Token",
  "path": "/api/v1.2/commission",
  "rejectCode": "1007"
}

Loading...