Place Cover Order

HTTP

Example

curl https://apix.stocksdeveloper.in/trading/placeCoverOrder \
   -H "api-key: <your-api-key>" \
   -d "pseudoAccount=ACC_NAME" \
   -d "exchange=<exchange>" \
   -d "symbol=SBIN" \
   -d "tradeType=BUY" \
   -d "orderType=LIMIT" \
   -d "quantity=10" \
   -d "price=180.5" \
   -d "triggerPrice=180"

Response

{
	"result":"200622000333410",
	"error":null,
	"message":null,
	"status":true,
	"commandId":"6d4b5738-c1aa-4623-b0c5-8df779e0f44d"
}

The response fields work as follows:

Python

Signature

def place_cover_order(self, pseudo_account, \
	exchange, symbol, tradeType, orderType, \
	quantity, price, triggerPrice):

Example

response = autotrader.place_cover_order( \
	'XX1234', '<exchange>', 'SBIN', 'SELL', 'LIMIT', \
	1, 188.15, 190.0)

if response.success():
    print("Result: {0}".format(response.result))
else:
    print("Message: {0}".format(response.message))

Java

Signature

/**
 * Places a cover order.
 *
 * @param pseudoAccount pseudo account
 * @param exchange      exchange
 * @param symbol        symbol
 * @param tradeType     trade type
 * @param orderType     order type
 * @param quantity      quantity
 * @param price         price
 * @param triggerPrice  trigger price
 * @return the order id given by your stock broker
 */
IOperationResponse<String> placeCoverOrder(
	String pseudoAccount, String exchange, 
	String symbol, TradeType tradeType, 
	OrderType orderType, int quantity, 
	float price, float triggerPrice);

Example

// Place a cover order
final IOperationResponse<String> response = 
	autotrader.placeCoverOrder("ACC_NAME", 
	"<exchange>", "SBIN", TradeType.BUY, OrderType.LIMIT, 
	10, 180.5f, 180f);

// Read order id
String orderId = null;
if (response.success()) {
	orderId = response.getResult();
} else {
	final String errorMessage = response.getMessage();
}

This places a cover order into the trading account mapped to the passed pseudo account. The response object has a success() method, which returns true on successful execution. Use getResult() to read the order id given by your trading platform.

C#

Signature

/// <summary>
/// Places a cover order. For more information, please see <a href=
/// "https://stocksdeveloper.in/documentation/api/place-cover-order/">api
/// docs</a>.
/// </summary>
/// <param name="pseudoAccount"> pseudo account </param>
/// <param name="exchange">      exchange </param>
/// <param name="symbol">        symbol </param>
/// <param name="tradeType">     trade type </param>
/// <param name="orderType">     order type </param>
/// <param name="quantity">      quantity </param>
/// <param name="price">         price </param>
/// <param name="triggerPrice">  trigger price </param>
/// <returns> the order id given by your stock broker </returns>
IOperationResponse<String> PlaceCoverOrder(
	string pseudoAccount, string exchange, 
	string symbol, TradeType tradeType, 
	OrderType orderType, int quantity, 
	float price, float triggerPrice);

Example

IOperationResponse<string> response = 
	autoTrader.PlaceCoverOrder("XX1234", 
	"<exchange>", "SBIN", TradeType.SELL,
	OrderType.MARKET, 3, 0, 218.4f);

if(response.Success()) {
    Console.WriteLine("Result: {0}", response.Result);
}
else {
    Console.WriteLine("Message: {0}", response.Message);
}

This places an order into the trading account mapped to the passed pseudo account. The response object has a Success() method, which returns true on successful execution. Use the Result property to read the order id given by your trading platform.

Excel

Signature

Public Function PlaceCoverOrder( _
    PseudoAccount As String, _
    Exchange As String, _
    Symbol As String, _
    TradeType As String, _
    OrderType As String, _
    Quantity As Integer, _
    Price As Double, _
    TriggerPrice As Double) As String

Example

Dim OrderId As String

OrderId = PlaceCoverOrder("ACC_NAME", _
	"<exchange>", "SBIN", "BUY", "LIMIT", 100, 200.55, 0)

AmiBroker

Signature

function placeCoverOrder(account, exchange, 
	symbol, tradeType, orderType, 
	quantity, price, triggerPrice, validate)

Example 1

// Apply your logic to calculate stoploss trigger price
stoplossTriggerPrice = buyPrice - 5;

// Place cover order
orderId = placeCoverOrder(AT_ACCOUNT, AT_EXCHANGE, 
	AT_SYMBOL, "BUY", "LIMIT", AT_QUANTITY, 
	buyPrice, stoplossTriggerPrice, True);

This places a cover order for the account, exchange and symbol chosen in the chart parameters. Some variables used above are parameters defined by the AutoTrader library.

Example 2

// Apply your logic to calculate stoploss trigger price
stoplossTriggerPrice = buyPrice - 5;

// Place cover order (Market)
orderId = placeCoverOrder("ACC_NAME", "<exchange>", 
	"SBIN", "BUY", "MARKET", 10, 
	0, stoplossTriggerPrice, True);

This places a MARKET cover order with quantity 10, so the order price is zero. Here the values are passed directly instead of using chart parameters.

MetaTrader

Signature

string placeCoverOrder(string account, 
	Exchange exchange, string symbol, 
	TradeType tradeType, OrderType orderType, 
	int quantity, double price, 
	double triggerPrice, bool validate)

Example 1

// Apply your logic to calculate stoploss trigger price
double stoplossTriggerPrice = buyPrice - 5;

// Place cover order
string id = placeCoverOrder(AT_ACCOUNT, 
	AT_EXCHANGE, AT_SYMBOL, BUY, LIMIT, 1, 
	192, stoplossTriggerPrice, true);

This places a cover order for the account, exchange and symbol chosen in the chart parameters. Some variables used above are parameters defined by the MetaTrader library.

Example 2

// Apply your logic to calculate stoploss trigger price
double stoplossTriggerPrice = buyPrice - 5;
 
// Place cover order (Market)
string id = placeCoverOrder("XX2030", 
    AT_EXCHANGE, "SBIN", BUY, MARKET, 10, 
    0, stoplossTriggerPrice, true);

This places a MARKET cover order with quantity 10, so the order price is zero.