Holdings and Limits
/NorenWClientAPI/HoldingsAuthorization token is required. Enter your access_token from GenAcsTok above.
"Use proxy" sends this request through this website's server, which never logs request or response bodies. Infinn sees the docs server's IP, not yours. Turn it off to send directly from your browser instead.
jData fields
Values are sent as a JSON string in the jData form field.
Logged in User Id
- Example:
YOUR_USER_ID - Where to get it: The ID you log in with at trade.infinn.in (User ID = Client ID). Also returned as uid by GenAcsTok.
Account id of the logged in user
- Example:
YOUR_USER_ID - Where to get it: Same as User ID for individual accounts. Returned by GenAcsTok / UserDetails.
Product name
- Example:
C - Allowed: C = Delivery, M = Margin, H = Cover, I = Intraday, B = Bracket, F = MTF, S = Special, P = Special2
Authorization Token
Required for all API calls. Use the access_token from the GenAcsTok response as a Bearer token.
⚠ When "Use proxy" is on, this token is sent through this website's server on its way to Infinn. It is never logged here, but if you would rather it never leave your browser, turn off "Use proxy" above or use the ready code with your own client instead.
Holdings
Request to be POSTed to url: /NorenWClientAPI/Holdings
Request Details:
| Parameter Name | Possible Value | Description |
|---|---|---|
| jData* | JSON object | Should send JSON object with fields in the list below |
| Authorization* | Bearer <access_token> | access_token from GenAcsTok response. Required for all API calls. |
JSON Fields:
| Field Name | Possible Value | Description |
|---|---|---|
| uid* | Logged in User Id | |
| actid* | Account id of the logged in user. | |
| prd* | Product name |
Response Details:
Response data will be in json format with the below fields in case of Success:
JSON Fields:
| Field Name | Possible Value | Description |
|---|---|---|
| stat | Ok or Not_Ok | Holding request success or failure indication. |
| exch_tsym | Array of objects exch_tsym objects as defined below. | |
| holdqty | Holding quantity | |
| dpqty | DP Holding quantity | |
| npoadqty | Non Poa display quantity | |
| colqty | Collateral quantity | |
| benqty | Beneficiary quantity | |
| unplgdqty | Unpledged quantity | |
| brkcolqty | Broker Collateral | |
| btstqty | BTST quantity | |
| btstcolqty | BTST Collateral quantity | |
| usedqty | Holding used today | |
| upldprc | Average price uploaded along with holdings | |
| hair_cut | Hair Cut | |
| prd | Product | |
| s_prdt_ali | Product display name | |
| trdqty | Trade Quantity | |
| sell_amt | Sell Amount | |
| npoadt1qty | nonpoa display t1 qty | |
| brk_hair_cut | Broker HairCut | |
| epi_done_qty | EPI done Quantity | |
| combrkcollqty | Com Broker Collateral Quantity | |
| eqtbrkcollqty | Eqt Broker Collateral Quantity | |
| derbrkcollqty | Derivative Broker Collateral Quantity | |
| fxbrkcollqty | Fx Broker Collateral Quantity |
Notes:
- Valuation:
btstqty + holdqty + brkcolqty + unplgdqty + benqty + Max(npoadqty, dpqty) - usedqty - Salable:
btstqty + holdqty + unplgdqty + benqty + dpqty - usedqty
exch_tsym Object:
| Field Name | Possible Value | 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 | |
| lp | LTP [#] | |
| cname | Company Name | |
| dname | Display Name |
Response data will be in json format with below fields in case of failure:
JSON Fields:
| Field Name | Possible Value | Description |
|---|---|---|
| stat | Not_Ok | Position book request failure indication. |
| request_time | Response received time. | |
| emsg | Error message |
[#] - By Default disabled and Enabled on request basis.
Sample Success Response:
[
{
"stat": "Ok",
"exch_tsym": [
{
"exch": "NSE",
"token": "13",
"tsym": "ABB-EQ"
}
],
"holdqty": "2000000",
"colqty": "200",
"btstqty": "0",
"btstcolqty": "0",
"usedqty": "0",
"upldprc": "1800.00"
},
{
"stat": "Ok",
"exch_tsym": [
{
"exch": "NSE",
"token": "22",
"tsym": "ACC-EQ"
}
],
"holdqty": "2000000",
"colqty": "200",
"btstqty": "0",
"btstcolqty": "0",
"usedqty": "0",
"upldprc": "1400.00"
}
]Sample Failure Response:
{
"stat": "Not_Ok",
"emsg": "Invalid Input : Missing uid or actid or prd."
}curl --request POST \
--url 'https://api.infinn.in/NorenWClientAPI/Holdings' \
--header 'Authorization: Bearer PASTE_ACCESS_TOKEN_HERE' \
--header 'Content-Type: text/plain' \
--data 'jData={"uid":"YOUR_USER_ID","actid":"YOUR_USER_ID","prd":"C"}'