Skip to main content

strategy

Bull Call Spread

The Bull Call Spread places two orders which both the legs will be call and in which the first one is bought and second one is sold, the strike price can be defined by the users.

Method : POST​

https://connect-go.thefirstock.tech/api/V5/bearCallSpread

Request details

API Parameters
Key Value Type Mandatory
userId NP2007 String Yes
jKey abc123 String Yes
callBuyStrikePrice 22500 String Yes
callSellStrikePrice 22500 String Yes
expiry 27Feb25 String Yes
symbol NIFTY String Yes
product C String Yes
quantity 1 String Yes
exchange NFO String Yes
priceType MKT String Yes
retention DAY String Yes
remarks BearCallSpread String No

Libraries and SDKs

Tabbed Interface 
curl --location 'https://connect-go.thefirstock.tech/api/V5/bearCallSpread' \
--header 'Content-Type: application/json' \
--data '{
    "userId": "NP2007",
    "jKey": "1478b9b7170b19809ac5068560f38dad493d35",
    "callBuyStrikePrice": "22500",
    "callSellStrikePrice": "22500",
    "expiry": "27FEB25",
    "symbol": "NIFTY",
    "product": "C",
    "quantity": "1",
    "exchange": "NFO",
    "priceType": "MKT",
    "retention": "DAY",
    "remarks": "BearCallSpread"
}'

Success response details

API Parameters
Parameter Description Example
status
String		 Status of the API request,
indicating whether it was
successful or not.		 success
data.requestTime
String		 Indicates the time at which
the response was received, providing
a timestamp for the transaction.		 17:49:14 16-02-2023
data.orderNumber
String		 Unique identifier for the order,
present only on successful Order
placement to OMS.		 1234567890 
[
  {
    status: "success",
    data: 
      [
  {
    "gui_order_id": "(null)",
    "handlinst": "(null)",
    "norenordno": 25031200006698,
    "req_status": "OK"
  },
  {
    "gui_order_id": "(null)",
    "handlinst": "(null)",
    "norenordno": 25031200006699,
    "req_status": "OK"
  }
]

  }
];

Failure response details

API Error Parameters
Parameter Description Example
status
String		 Indicates the result status of
the API operation		 failed
code
String		 HTTP status code associated with
the error		 401
name
String		 Specifies the type or category
of the error encountered		 INVALID_JKEY
error.field
String		 Field in the request that
triggered the error		 jkey
error.message
String		 Detailed message describing
the error		 jKey parameter is
invalid		 
[
  {
    status: "failed",
    code: "401",
    name: "INVALID_JKEY",
    error: {
      field: "jKey",
      message: "jKey parameter is invalid",
    },
  }
];