---
title: "Search Contract Rules"
method: POST
path: "/iserver/contract/rules"
tags: ["tradingContracts"]
---

# Search Contract Rules

`POST /iserver/contract/rules`

Returns trading related rules for a specific contract and side.

## Request body

- object
  - `conid` integer, required — Contract identifier for the interested contract.
  - `isBuy` boolean — Side of the market rules apply too. Set to true for Buy Orders, set to false for Sell orders.
  - `modifyOrder` boolean — Used to find trading rules related to an existing order.
  - `orderId` integer — Specify the order identifier used for tracking a given order.

## Response `200`

An array of objects detailing contract information.

- ContractRules — detailed contract information
  - `algoEligible` boolean — Indicates if the contract can trade algos or not.
  - `allOrNoneEligible` boolean — indicates all or non option is eligible for given contract.
  - `costReport` boolean — Indicates whether or not a cost report has been requested (Client Portal only).
  - `canTradeAcctIds` string[] — Indicates permitted accountIDs that may trade the contract.
  - `error` string, nullable — If rules information can not be received for any reason, it will be expressed here.
  - `orderTypes` ContractRulesOrderTypesItems[] — Indicates permitted order types for use with standard quantity trading.
  - `ibAlgoTypes` ContractRulesIbAlgoTypesItems[] — Indicates permitted algo types for use with the given contract.
  - `fraqTypes` ContractRulesFraqTypesItems[] — Indicates permitted order types for use with fractional trading.
  - `forceOrderPreview` boolean — Indicates if the order preview is forced upon the user before submission.
  - `cqtTypes` ContractRulesCqtTypesItems[] — Indicates accepted order types for use with cash quantity.
  - `orderDefaults` ContractRulesOrderDefaults — Indicates default order type for the given security type.
    - `LMT` ContractRulesOrderDefaultsLmt
      - `LP` string — Indicates a Limit Price default value.
  - `orderTypesOutside` ContractRulesOrderTypesOutsideItems[] — Indicates permitted order types for use outside of regular trading hours.
  - `defaultSize` integer — Default total quantity value for orders.
  - `cashSize` integer — Default cash value quantity.
  - `sizeIncrement` integer — Indicates quantity increase for the contract.
  - `tifTypes` string[] — Indicates allowed tif types supported for the contract.
  - `tifDefaults` ContractRulesTifDefaults — Object containing details about your TIF value defaults. These defaults can be viewed and modified in TWS's within the Global Configuration.
    - `TIF` string — The default TIF type for orders.
    - `SIZE` string — The default size value for orders.
    - `DEFAULT_ACCT` string — default account (multi account only)
    - `PMALGO` boolean
  - `limitPrice` number, double — Default limit price for the given contract.
  - `stopPrice` number, double — Default stop price for the given contract.
  - `orderOrigination` string, nullable — Order origin designation for US securities options and Options Clearing Corporation
  - `preview` boolean — Indicates if the order preview is required (for client portal only)
  - `displaySize` integer, nullable — Standard display increment rule for the instrument.
  - `fraqInt` integer — Indicates decimal places for fractional order size.
  - `cashCcy` string — Indicates base currency for the instrument.
  - `cashQtyIncr` integer — Indicates cash quantity increment rules.
  - `priceMagnifier` integer, nullable — Signifies the magnifier of a given contract. This is separate from the price multiplier, and will typically return 'null'
  - `negativeCapable` boolean — Indicates if the value of the contract can be negative (true) or if it is always positive (false).
  - `incrementType` integer — Indicates the type of increment style.
  - `incrementRules` ContractRulesIncrementRulesItems[] — Indicates increment rule values including lowerEdge and increment value.
    - `lowerEdge` integer — If the current mark price of the instrument is at or above the lower edge, the given increment value is used for order prices.
    - `increment` integer — The price of the instrument must be submitted as a mulitple of the increment value.
  - `hasSecondary` boolean
  - `modTypes` unknown[] — Lists the available order types supported when modifying the order.
    - unknown
  - `increment` number, double — Minimum increment values for prices
  - `incrementDigits` integer — Number of decimal places to indicate the increment value.

## Other responses

- `401` — Missing, invalid, or unparseable Authorization token.
- `500` — internal server error, returned when incoming request cannot be processed. It can sometimes include subset of bad requests. For example, wrong accountId passed and it can only be detected later in handling request. Error contains reason of the problem.
- `503` — service is unavailable. For example if request takes more than 10s due to some internal service unavailability, request aborted and this status returned

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)