---
title: "Instrument Definition Detail"
method: GET
path: "/trsrv/secdef"
tags: ["tradingContracts"]
---

# Instrument Definition Detail

`GET /trsrv/secdef`

Returns a list of security definitions for the given conids.

## Query parameters

- `conids` string, required

## Response `200`

Successful response containing a contract's security definition.

- TrsrvSecDefResponse — a contract's security definition
  - `secdef` TrsrvSecDefResponseSecdefItems[]
    - `conid` integer — The conID
    - `currency` string — The traded currency for the contract.
    - `time` integer — Amount of time in ms to generate the data.
    - `chineseName` string — The Chinese characters for the symbol.
    - `allExchanges` string — A series of exchanges the given symbol can trade on.
    - `listingExchange` string — The primary or listing exchange the contract is hosted on.
    - `countryCode` string — The country code the contract is traded on.
    - `name` string — The company name.
    - `assetClass` string — The asset class or security type of the contract.
    - `expiry` string, nullable — The expiry of the contract. Returns null for non-expiry instruments.
    - `lastTradingDay` string, nullable — The last trading day of the contract.
    - `group` string — The group or industry the contract is affilated with.
    - `putOrCall` string, nullable — a Put or Call option.
    - `sector` string — The contract's sector.
    - `sectorGroup` string — The sector's group.
    - `strike` string — The strike of the contract.
    - `ticker` string — The ticker symbol of the traded contract.
    - `undConid` integer — The contract's underlyer.
    - `multiplier` integer — The contract multiplier.
    - `type` string — Stock type.
    - `hasOptions` boolean — contract has tradable options contracts.
    - `fullName` string — Returns symbol name for requested contract.
    - `isUS` boolean — The contract is US based or not.
    - `incrementRules` TrsrvSecDefResponseSecdefItemsIncrementRulesItems[] — Indicates increment rule values including lowerEdge and increment value.
      - `lowerEdge` number, double — 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` number, double — The price of the instrument must be submitted as a mulitple of the increment value.
    - `displayRule` TrsrvSecDefResponseSecdefItemsDisplayRuleItems[] — Returns rules regarding incrementation for order placement. Not functional for all exchanges. Please see /iserver/contract/rules for more accurate rule details.
      - `magnification` integer — If the displayed contract information is multiplied based on a given magnitude, the value will be reflected here.
      - `displayRuleStep` TrsrvSecDefResponseSecdefItemsDisplayRuleItemsDisplayRuleStepItems[]
        - `decimalDigits` integer — Displays the total number of digits used after the decimal value.
        - `lowerEdge` number, double — The lowerEdge display value to correspond to increment rules.
        - `wholeDigits` integer — Displays valid display prices for before and after the decimal value.
    - `isEventContract` boolean — The contract is an event contract or not.
    - `pageSize` integer — Returns the content size of the request.

## Other responses

- `400` — Missing, empty, non-numeric, or out-of-range parameter. The `error` field is always prefixed with `Bad Request:`.
- `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)