99.99% of API orders are in derivative segment, but all examples are in Equity (Segment) why?

Namaskara,

In my opinion 99.9% of the orders using the API is in the derivative segment (futures and options, … chiefly options).

However all the documentation examples are entirely of Equity segment.

For Eg: Place Order

{
“quantity”: 1,
“product”: “D”,
“validity”: “DAY”,
“price”: 0,
“tag”: “string”,
“instrument_token”: “NSE_EQ|INE848E01016”,
“order_type”: “MARKET”,
“transaction_type”: “BUY”,
“disclosed_quantity”: 0,
“trigger_price”: 0,
“is_amo”: false
}

while its illustrative, but not comprehensive.

Please give thought : Make the documented examples that are more relevant to the majority of usage… Please give comprehensive set of examples in

  1. Index Options
  2. Stock Options
  3. Index Futures
  4. Stock Futures
  5. Commodity options
  6. Commodity Futures

That way it will be easy for any developer to test this syntax and semantics easily.

Regards
Rathnadhar K V

Hi @RathnadharKV
We understand that most API orders are for derivative segments. However, derivative instrument keys expire regularly, and using expired instruments in examples would be unhelpful to users.

Additionally, we prefer to use equity stocks priced under ₹100 for examples. This minimizes financial risk if a user inadvertently copies and places an order. Furthermore, a sell order for an equity stock requires EDIS if present in your holdings. If a user unknowingly copies a sell order example with a derivative instrument, it could lead to a short sell of an option, which requires significant margin and poses a substantial financial risk for someone merely trying out the API. Our intention behind using inexpensive equity instruments in examples was to mitigate these risks.

I hope this helps.

Thanks!

Namaskara,

Thanks for the lighthning speed reply!

Example are as name states are examples.

They are not live code/templates. They are there for coding reference that is all. Nobody gets influenced by examples to hard code the values in live. If they are so dumbos then they dont deserve to be a developer. These API are certainly not meant for them.

Further if you give example of an expired contract. That is more fool proof than any equity under 100 Rs. scenario, since the exchange itself will reject the order therefore, there is no financial liability.

My question still stands and my request is

Please give examples of Derivative segments in NSE and MCX.

Regards
Rathnadhar K V