Brokerage and Statutory charges
This API provides the brokerage and all applicable statutory charges (e.g. STT, GST, SEBI charges) for a given order. Configuration is based on ODIN Admin settings.
Note⚠️
This API is not for multileg orders. Use this only for single-leg orders.
| Headers | Type | Required | Description | Example/ENUM |
|---|
| Authorization | string | Yes | Bearer token for authentication | Bearer {{access_token}} |
| x-api-key | string | Yes | API key for access | {{x-api-key}} |
| Content-Type | string | Yes | Request format | application/json |
📦Request Body Schema
| Field | Type | Description | Example/ENUM |
|---|
| marketSegmentId | integer | Exchange segments ID | 1 |
| series | string | "EQ" for equities; for others use "XX" or leave blank | "EQ", "XX" |
| productType | string | Type of order product | MARGIN, DELIVERY, CARRYFORWARD, etc. |
| transactionType | integer | 1 = Buy, 2 = Sell | 1 |
| quantity | integer | Order quantity | 100 |
| price | float | Order price per unit (in ₹) | 253.75 |
| brokerage | float | Value from GetOrderMarginInfo API | 20.00 |
| legIndicator | integer | 1 = Normal (for single-leg orders only) | 1 |
| instrument | string | Instrument type | EQUITIES, FUTSTK, OPTSTK |
| priceLocator | integer | Always 1, unless handling commodities (special calculation logic applies)((PriceNum / PriceDen) * (nAVMBuyMargin / nAVMSellMargin)) And for NCDEX as: (PriceNum / PriceDen) These values are available with ScripInfo API calls. | 1 |
🟢Success Response - 200 Ok
| Field | Type | Description | Example/ENUM |
|---|
| status | string | Status of the API call | "success" |
| code | string | Response code | "s-101" |
| message | string | Response message | "Success" |
| data | object | Contains all brokerage and statutory charge details | See below table |
📝Brokerage details Object Fields
| Field | Type | Description | Example/ENUM |
|---|
| orderValue | integer | Calculated total value of the order | 25375.00 |
| totalBrcokerageAndCharges | integer | Sum of all charges and taxes | 30.65 |
| brokerage | integer | Brokerage charged for the order | 20.00 |
| securitiesTransactionTax | integer | STT applicable | 5.07 |
| transactionCharges | integer | Exchange transaction charges | 1.10 |
| gst | integer | Goods & Services Tax (GST) | 2.45 |
| stampDuty | integer | Stamp duty on the transaction | 0.78 |
| sebiCharges | integer | SEBI charges | 0.20 |
| dpCharges | integer | DP (Depository Participant) charges (if applicable) | 0.00 |
| clearingCharges | integer | Charges for clearinghouse processing | 1.05 |
💬Notes:
- Use this API to pre-calculate all charges for a given order before placing it.
- Integrates well with GetOrderMarginInfo for end-to-end margin + cost computation.
- Helps in displaying cost breakdown to users before order execution.