---
title: "Secdef by Conid"
method: POST
path: "/trsrv/secdef"
tags: ["Contract"]
---

# Secdef by Conid

`POST /trsrv/secdef`

Returns a list of security definitions for the given conids

## Request body

- object
  - `conids` integer[]

## Response `200`

returns an array of secdef info

- object[]
  - `conid` integer — IBKR contract identifier.
  - `currency` string — Currency contract trades in.
  - `crossCurrency` boolean — Defines if a derivative contract has a different currency.
  - `time` integer
  - `chineseName` string — HTML encoded company description in Chinese.
  - `allExchanges` string — List of exchanges and venues contract trades.
  - `listingExchange` string — Main trading venue.
  - `name` string — Company Name.
  - `assetClass` string — Group of financial instruments which have similar financial characteristics and behave similar in the marketplace.
  - `expiry` string — Specific data contract expires.
  - `lastTradingDay` string — Final day derivative contract can be traded before delivery of the underlying asset or cash settlement.
  - `group` string — Potential characteristic of each product.
  - `putOrCall` string — Defines the right to buy or sell of the underlying security.
  - `sector` string — The category of the economy.
  - `sectorGroup` string — Stock Group contract belongs too.
  - `strike` number — Set price at which a derivative contract can be bought or sold.
  - `ticker` string — Contract symbol.
  - `undConid` integer — Underlying contract identifier.
  - `multiplier` integer — Multiplier for total premium paid or received for derivative contract.
  - `type` string — Stock type.
  - `undComp` string — Company name for underlying contract.
  - `undSym` string — IBKR Symbol for underlying contract.
  - `hasOptions` boolean — If contract has an option.
  - `fullName` string — Formatted company name with underlying symbol, expiration, strike, right.
  - `isUS` boolean — If contract is a US contract. Currently supported for stocks, options and warrants.
  - `incrementRules` object — Price increment value contract trades.
    - `lowerEdge` number — The minimum contract price on the market that supports the specified increment.
    - `increment` number — The minimum increment value for contract price.

---

[API](https://skmtc.dev/ibkr/apis/client-portal-web-api.md) · [All operations](https://skmtc.dev/ibkr/apis/client-portal-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ibkr/client-portal-web-api/revisions/32edbfe496d1/schema)