Get Commission & VAT

POST 
/v1.1/order/commission-vat

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.

Supported Asset Classes

Equity

Request Body

{
"accountNumber": "P000128310",
"quantity": 10,
"price": 5,
"exchange": "NSDQ",
"symbol": "AAPL",
"tradingSession": "REG",
"orderType": 1,
"securityType": "CS",
"orderValue": 50
}

Field Name   accountNumber required symbol required exchange required quantity optional   orderType required orderSide required

Field Name   price required selectively  tif required expiryDate required selectively (GTD) tradingSession optional orderValue optional   securityType optional amount N/A

Option

Request Body

{
  "accountNumber": "P000128310",
  "symbol": "AAPL\\23F30\\65.0",
  "exchange": "OPRA",
  "price": 10,
  "quantity": 1000,
  "orderType": 1,
  "securityType": "OPT"
}

Field Name   accountNumber required symbol required exchange required quantity optional   orderType required orderSide required

Field Name   price required selectively  tif required expiryDate required selectively (GTD) tradingSession N/A orderValue N/A securityType required amount N/A

Fixed Income

Request Body

{
"accountNumber": "P000284369",
"symbol": "ANF 8 ¾ 07/15/25",
"exchange": "BOND",
"amount": 2000,
"orderType": "2",
"orderSide": 1,
"price": 50,
"tif": 0,
"expireDate": "2023/11/10",
"securityType": "BND",
"orderValue": 1000
}

Field Name   accountNumber required symbol required exchange required quantity N/A orderType required orderSide required

Field Name   price required selectively tif required expiryDate required selectively (GTD) tradingSession N/A orderValue N/A; securityType required amount required

Request

application/json

Body

accountNumber stringrequired

Security account number

price numberrequired
quantity number
exchange stringrequired
symbol stringrequired
tradingSession string

Default value: REG

For trading Sessions - Master data > Get Support Trading Sessions

orderType integerrequired

For Order types - Master Data > Get Exchange Order Types

securityType stringrequired

Possible values: [CS, OPT, BND]

CS ; common stock/ equity , OPT ; option , BND ; fixed income

orderValue number

Responses

200

OK

application/json

Schema

Schema

status stringrequired
reason stringrequired
rejectCode integer

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.1/commission",
  "rejectCode": "1008"
}

Expired Token

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

Loading...