Block Option Order

Create a Block Options Order.

POST

/trading-api/v1/optionorder/create-block

Request

Query Parameters

Name	Data Type	Description
verifyOnly	Boolean	True: does not submit order. Response body will not return an orderId <br/> False: immediately submits order through API. If the order is successfully, the Response Body will return an orderId`

Body

The Request Body to create a Block Options Order includes several required fields. This ensures that the created order has all necessary parameters for the order to return with no errors.

This request must consist of the below Stonex identifiers:

Schema

Attributes	Data Type	Length	Value
inventoryAccountNumber	String	4	Assigned Account identifier
inventorySubNumber	String	3	Assigned Firm identifier
stopPrice	Number		Price assigned to trigger a Stope order
limitPrice	Number		Price assigned to a Limit Order
solicited	Boolean		True or False
notHeld	Boolean		True or False
underlyingSymbol	String		Cusip, Isin, Sedol, Symbol
expirationDate	String		(date-time)
putCallIndicator	String		Put, Call
strikePrice	Number		The price at which a Put or Call can be exercised
quantity	Number		Amount
action	String		Buy, Sell, BuyToCover, SellShort
timeInForce	String		Day, GoodTillCancel, FillOrKill, GTXPre, NTE

Example

{
  "inventoryAccountNumber": "string",
  "inventorySubNumber": "string",
  "stopPrice": 0,
  "limitPrice": 0,
  "solicited": false,
  "notHeld": false,
  "underlyingSymbol": "string",
  "expirationDate": "2024-05-09T17:26:23.856Z",
  "putCallIndicator": "Put",
  "strikePrice": 0,
  "quantity": 0,
  "action": "BuyToOpen",
  "timeInForce": "Day"
}

Response Body

Responses from the request will return with a Status Code.

There are 3 Codes: Successful (200), Bad Request (400) and Internal Server Error (500).

Successful Response

The response for a Successful request will look like:

Schema

A successful request will respond with a result containing the account number and account status

Attributes	Data Type	Length	Description
statusCode	Integer	3	Code identifies success of request
message	String		Outcome of request
data	Data Block		Main field containing information of request
errors	Errors		API errors
traceId	String		Unique identifier
hasErrors	Boolean		True or False

Example

{
  "statusCode": 0,
  "message": "string",
  "data": {
    "inventoryAccountIdentifier": {
      "accountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "subNo": "string",
      "branchNo": "string",
      "accountNumber": "string",
      "name": "string",
      "sourceSystem": "string",
      "subType": "Discretionary",
      "catType": "string"
    },
    "allocationOptionOrders": [
      {
        "clientAccountIdentifier": {
          "accountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "subNo": "string",
          "branchNo": "string",
          "accountNumber": "string",
          "name": "string",
          "sourceSystem": "string",
          "subType": "Discretionary",
          "catType": "string"
        },
        "noPostage": false,
        "allOrNone": false,
        "ttoRep": "string",
        "commissionType": "FlatRate",
        "commissionSchedule": 0,
        "commissionAmount": 0,
        "calculatedCommission": 0,
        "confirmNote": "string",
        "blockOptionOrder": "string",
        "orderId": "00000000-0000-0000-0000-000000000000",
        "orderNumber": "00000000",
        "orderType": "Single",
        "accountType": "Cash",
        "action": "BuyToOpen",
        "timeInForce": "Day",
        "orderStatus": "Verification",
        "securityIdentifier": {
          "securityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "securityNumber": "string",
          "sourceSystem": "string",
          "symbol": "string",
          "underlyingSymbol": "string",
          "isin": "string",
          "sedol": "string",
          "cusip": "string",
          "description": "string",
          "strikePrice": 0,
          "expirationDate": "2024-05-09T17:26:23.857Z",
          "displaySymbol": "string"
        },
        "openCloseIndicator": "Open",
        "quantity": 0,
        "filledQuantity": 0,
        "solicited": false,
        "notHeld": false,
        "tradeInfo": {
          "buyingPower": 0,
          "estimatedSettlementDate": "2024-05-09T17:26:23.857Z",
          "estimatedPrincipal": 0,
          "estimatedNetTotal": 0,
          "estimatedCommission": 0,
          "estimatedHandlingFee": 0,
          "estimatedPostageFee": 0,
          "estimatedSecFee": 0,
          "estimatedFirmFee": 0,
          "estimatedPrice": 0,
          "actualPrincipal": 0,
          "actualNetTotal": 0,
          "actualCommission": 0,
          "actualHandlingFee": 0,
          "actualPostageFee": 0,
          "actualSecFee": 0,
          "actualPrice": 0
        },
        "averageTradePriceAmount": 0,
        "orderWarnings": [
          "string"
        ],
        "orderError": {
          "code": "string",
          "target": "string",
          "message": "string",
          "details": [
            "string"
          ]
        },
        "enteredDate": "2024-05-09T17:26:23.857Z",
        "completedDate": "2024-05-09T17:26:23.857Z"
      }
    ],
    "stopPrice": 0,
    "limitPrice": 0,
    "orderId": "00000000-0000-0000-0000-000000000000",
    "orderNumber": "00000000",
    "orderType": "Single",
    "accountType": "Cash",
    "action": "BuyToOpen",
    "timeInForce": "Day",
    "orderStatus": "Verification",
    "securityIdentifier": {
      "securityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "securityNumber": "string",
      "sourceSystem": "string",
      "symbol": "string",
      "underlyingSymbol": "string",
      "isin": "string",
      "sedol": "string",
      "cusip": "string",
      "description": "string",
      "strikePrice": 0,
      "expirationDate": "2024-05-09T17:26:23.857Z",
      "displaySymbol": "string"
    },
    "openCloseIndicator": "Open",
    "quantity": 0,
    "filledQuantity": 0,
    "solicited": false,
    "notHeld": false,
    "tradeInfo": {
      "buyingPower": 0,
      "estimatedSettlementDate": "2024-05-09T17:26:23.857Z",
      "estimatedPrincipal": 0,
      "estimatedNetTotal": 0,
      "estimatedCommission": 0,
      "estimatedHandlingFee": 0,
      "estimatedPostageFee": 0,
      "estimatedSecFee": 0,
      "estimatedFirmFee": 0,
      "estimatedPrice": 0,
      "actualPrincipal": 0,
      "actualNetTotal": 0,
      "actualCommission": 0,
      "actualHandlingFee": 0,
      "actualPostageFee": 0,
      "actualSecFee": 0,
      "actualPrice": 0
    },
    "averageTradePriceAmount": 0,
    "orderWarnings": [
      "string"
    ],
    "orderError": {
      "code": "string",
      "target": "string",
      "message": "string",
      "details": [
        "string"
      ]
    },
    "enteredDate": "2024-05-09T17:26:23.857Z",
    "completedDate": "2024-05-09T17:26:23.857Z"
  },
  "errors": [
    {
      "code": "string",
      "field": "string",
      "reason": "string"
    }
  ],
  "traceId": "string",
  "hasErrors": true
}