Search Instruments By Symbol

GET

/iserver/secdef/search

GET

/v1/api/iserver/secdef/search

$ curl https://api.ibkr.com/v1/api/iserver/secdef/search

1 [
2   {
3     "conid": "8314",
4     "companyHeader": "INTL BUSINESS MACHINES CORP - NYSE",
5     "companyName": "INTL BUSINESS MACHINES CORP",
6     "symbol": "IBM",
7     "description": "NYSE",
8     "restricted": null,
9     "fop": null,
10     "opt": "20240315;20240322;20240328;20240405;20240412;20240419;20240426;20240517;20240621;20240719;20240920;20241018;20250117;20250620;20260116",
11     "war": "20240208;20240213;20240214;20240215;20240216;20240222;20240226;20240227;20240228;20240229;20240301;20240304;20240305;20240306;20240307;20240308;20240311;20240312;20240313;20240314;20240315;20240416;20240418;20240514;20240516;20240618;20240619;20240620;20240621;20240718;20240917;20240918;20240919;20240920;20241017;20241217;20241218;20241219;20241220;20250114;20250115;20250116;20250117;20250319;20250320;20250617;20250618;20250619;20250620;20250918;20251216;20251218;20260113;20260115",
12     "sections": [
13       {
14         "secType": "STK"
15       },
16       {
17         "secType": "OPT",
18         "months": "MAR24;APR24;MAY24;JUN24;JUL24;SEP24;OCT24;JAN25;JUN25;JAN26",
19         "exchange": "SMART;AMEX;BATS;BOX;CBOE;CBOE2;EDGX;EMERALD;GEMINI;IBUSOPT;ISE;MEMX;MERCURY;MIAX;NASDAQBX;NASDAQOM;PEARL;PHLX;PSE"
20       },
21       {
22         "secType": "WAR",
23         "months": "FEB24;MAR24;APR24;MAY24;JUN24;JUL24;SEP24;OCT24;DEC24;JAN25;MAR25;JUN25;SEP25;DEC25;JAN26",
24         "exchange": "EBS;FWB;GETTEX;SBF;SWB"
25       },
26       {
27         "secType": "IOPT"
28       },
29       {
30         "secType": "CFD",
31         "exchange": "SMART",
32         "conid": "118239202"
33       },
34       {
35         "secType": "BAG"
36       }
37     ]
38   },
39   {
40     "conid": "41645598",
41     "companyHeader": "INTL BUSINESS MACHINES CORP - LSE",
42     "companyName": "INTL BUSINESS MACHINES CORP",
43     "symbol": "IBM",
44     "description": "LSE",
45     "restricted": null,
46     "fop": null,
47     "opt": null,
48     "war": null,
49     "sections": [
50       {
51         "secType": "STK"
52       }
53     ]
54   },
55   {
56     "bondid": 5,
57     "conid": "2147483647",
58     "companyHeader": "Corporate Fixed Income",
59     "companyName": null,
60     "restricted": null,
61     "fop": null,
62     "opt": null,
63     "war": null,
64     "sections": [
65       {
66         "secType": "BOND"
67       }
68     ],
69     "issuers": [
70       {
71         "id": "e5499005",
72         "name": "IBM International Capital Pte Ltd"
73       },
74       {
75         "id": "e1580374",
76         "name": "IBM-CALL"
77       },
78       {
79         "id": "e1400789",
80         "name": "International Business Machines Corp"
81       },
82       {
83         "id": "e1658116",
84         "name": "Truven Health Analytics Inc"
85       }
86     ]
87   }
88 ]

Returns a list of contracts based on the search symbol provided as a query param.

Query parameters

symbolstringOptional

secTypeenumOptionalDefaults to STK

Available underlying security types:

STK - Represents an underlying as a Stock security type.
IND - Represents an underlying as an Index security type.
BOND - Represents an underlying as a Bond security type.

Available underlying security types: * `STK` - Represents an underlying as a Stock security type. * `IND` - Represents an underlying as an Index security type. * `BOND` - Represents an underlying as a Bond security type.

Allowed values:

namebooleanOptional

morebooleanOptional

fundbooleanOptional

fundFamilyConidExstringOptional

patternbooleanOptional

referrerstringOptional

Response

An array of objects detailing contract information.

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

503

Service Unavailable Error