---
title: "Get security definition"
method: GET
path: "/secdef"
tags: ["Financial Instrument Definitions"]
---

# Get security definition

`GET /secdef`

Fields that compose security definition. Allowed combinations,
(1) type and symbol and currency, or
(2) type, symbol, exchange, and currency, or
(3) conid

## Request body

- object
  - `type` string — The instrument type of the contract (CASH).
  - `symbol` string — The symbol that identifies the trading product.
  - `currency` string — The currency in which the given pair trades.
  - `exchange` string — The exchange on which the trading product is listed (required for type=STK).
  - `conid` number — The internal IB identifier for the trading product specified as an integer.

## Response `200`

Financial Instrument Definition

- object[]
  - `ContractId` number
  - `Ticker` string
  - `SecurityType` string
  - `Exchange` string
  - `CompanyName` string
  - `Currency` string

## Other responses

- `202` — Unsuccessfull response
- `204` — Unsuccessfull response
- `400` — Unsuccessfull response
- `401` — Unsuccessfull response
- `403` — Unsuccessfull response
- `408` — Unsuccessfull response

---

[API](https://skmtc.dev/interactivebrokers/apis/ibkr-3rd-party-web-api.md) · [All operations](https://skmtc.dev/interactivebrokers/apis/ibkr-3rd-party-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interactivebrokers/ibkr-3rd-party-web-api/revisions/97f75703dba5/schema)