Infinn API Documentation
Order and Trades

Order Margin

POST/NorenWClientAPI/GetOrderMargin

Authorization 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.

Login users account ID

  • Example: YOUR_USER_ID
  • Where to get it: Same as User ID for individual accounts. Returned by GenAcsTok / UserDetails.

Exchange (Select from ‘exarr’ Array provided in User Details response)

  • Example: NSE
  • Where to get it: 'exarr' array in the UserDetails response.
  • Allowed: NSE, NFO, BSE, MCX, CDS, NCX, BFO, BCD

Unique id of contract on which order to be placed. (use url encoding to avoid special char error for symbols like M&M)

  • Example: RELIANCE-EQ
  • Where to get it: SearchScrip reply, or the TradingSymbol column of the exchange symbol file.

Order Quantity

  • Example: 1
  • Where to get it: Quantity in units (for F&O a multiple of the lot size).

Order Price

  • Example: 1000
  • Where to get it: Your limit price. Use "0" for MKT / SL-MKT orders.

Only to be sent in case of SL-LMT / SL-MKT order.

  • Example: 995
  • Where to get it: Trigger price, only for SL-LMT / SL-MKT orders.

Product name (Select from ‘prarr’ Array provided in User Details response, and if same is allowed for selected, exchange. Show product display name, for user to select, and send corresponding prd in API call)

  • Example: C
  • Allowed: C = Delivery, M = Margin, H = Cover, I = Intraday, B = Bracket, F = MTF, S = Special, P = Special2

B -> BUY, S -> SELL

  • Example: B
  • Allowed: B = buy, S = sell

LMT / MKT / SL-LMT / SL-MKT

  • Example: LMT
  • Allowed: LMT, MKT, SL-LMT, SL-MKT, DS, 2L, 3L

Book loss Price applicable only if product is selected as H and B (High Leverage and Bracket order)

Optional field. Application only for modify order, open order quantity

Optional field. Application only for modify order, quantity already filled.

Optional field. Application only for modify order, open order price

Optional field. Application only for modify order, open order trigger price

Optional field. Application only for H or B order modification

  • Example: 24010100000001
  • Where to get it: norenordno returned by PlaceOrder, or listed in the OrderBook.

Optional field. Application only for H or B order modification

Optional field.

Optional field.

Optional field.

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.

Request to be POSTed to url : /NorenWClientAPI/GetOrderMargin

Request Details
Parameter NamePossible valueDescription
jData*Should send json object with fields in below list
Authorization*Bearer <access_token>access_token from GenAcsTok response. Required for all API calls.
Json FieldsPossible valueDescription
uid*Logged in User Id
actid*Login users account ID
exch*NSE / NFO / BSE / MCXExchange (Select from ‘exarr’ Array provided in User Details response)
tsym*Unique id of contract on which order to be placed. (use url encoding to avoid special char error for symbols like M&M)
qty*Order Quantity
prc*Order Price
trgprcOnly to be sent in case of SL-LMT / SL-MKT order.
prd*C / M / HProduct name (Select from ‘prarr’ Array provided in User Details response, and if same is allowed for selected, exchange. Show product display name, for user to select, and send corresponding prd in API call)
trantype*B / SB -> BUY, S -> SELL
prctyp*LMT / MKT / SL-LMT / SL-MKT
blprcBook loss Price applicable only if product is selected as H and B (High Leverage and Bracket order)
rorgqtyOptional field. Application only for modify order, open order quantity
fillsharesOptional field. Application only for modify order, quantity already filled.
rorgprcOptional field. Application only for modify order, open order price
orgtrgprcOptional field. Application only for modify order, open order trigger price
norenordnoOptional field. Application only for H or B order modification
snonumOptional field. Application only for H or B order modification
rms_exchOptional field.
rms_segOptional field.
rms_prdOptional field.
Response Details

Response data will be in json format with below fields:

Json FieldsPossible valueDescription
statOk or Not_OkPlace order success or failure indication.
request_timeResponse received time.
remarksThis field will be available only on success.
cashTotal credits available for order
marginusedMeaning changes with remarks as explained below.
ordermarginMargin required for this order.
marginusedprevMargin used excluding this order
emsgThis will be present only if Order placement fails

Possible Response Cases for Order margin:

"remarks":"Order Success" => Order will go through. "cash" field will have total cash available with the user. "marginused" field will have Margin used if the user places order.

"remarks":"Insufficient Balance" => Order will get rejected. "cash" field will have total cash available for this type of order. "marginused" field will have Additional margin required for this order to pass through. (Show caption as Shortfall margin)

"remarks":"Order Success : Eligible Sell:" => Order will go through

"remarks":"Eligible Sell: " => Order will get rejected.

"remarks":"No Holdings uploaded" => Order will get rejected, no holding for this symbol

"remarks":"Invalid scrip" or "RED is under Reconciliation" => Order will get rejected.

curl --request POST \
  --url 'https://api.infinn.in/NorenWClientAPI/GetOrderMargin' \
  --header 'Authorization: Bearer PASTE_ACCESS_TOKEN_HERE' \
  --header 'Content-Type: text/plain' \
  --data 'jData={"uid":"YOUR_USER_ID","actid":"YOUR_USER_ID","exch":"NSE","tsym":"RELIANCE-EQ","qty":"1","prc":"1000","prd":"C","trantype":"B","prctyp":"LMT"}'
Response will appear here after sending a request