Instrument Definition Detail

GET

/trsrv/secdef

GET

/v1/api/trsrv/secdef

$ curl -G https://api.ibkr.com/v1/api/trsrv/secdef \
>      --data-urlencode conids=265598,8314

1 {
2   "secdef": [
3     {
4       "conid": 8314,
5       "currency": "USD",
6       "time": 770,
7       "chineseName": "&#x56FD;&#x9645;&#x5546;&#x4E1A;&#x673A;&#x5668;",
8       "allExchanges": "AMEX,NYSE,CBOE,PHLX,CHX,ARCA,ISLAND,ISE,IDEAL,NASDAQQ,REALNYSE,DRCTEDGE,BEX,BATS,NITEECN,EDGEA,CSFBALGO,PSX,BYX,ITG,PDQ,IBKRATS,NYSEFLOOR,CITADEL,NYSEDARK,MIAX,IBDARK,CITADELDP,NASDDARK,IEX,WEDBUSH,SUMMER,WINSLOW,FINRA,LIQITG,UBSDARK,BTIG,VIRTU,JEFF,OPCO,COWEN,DBK,JPMC,EDGX,JANE,NEEDHAM,FRACSHARE,RBCALGO,VIRTUDP,BAYCREST,FOXRIVER,MND,NITEEXST,PEARL,GSDARK,NITERTL,NYSENAT,IEXMID,HRT,FLOWTRADE,HRTDP,JANELP,PEAK6,CTDLZERO,HRTMID,JANEZERO,HRTEXST,IMCLP,LTSE,SOCGENDP,MEMX,INTELCROS,VIRTUBYIN,JUMPTRADE,NITEZERO,TPLUS1,XTXEXST,XTXDP,XTXMID,COWENLP,BARCDP,JUMPLP,OLDMCLP,RBCCMALP,WALLBETH,IBEOS,JONES,GSLP,BLUEOCEAN,USIBSILP,OVERNIGHT,JANEMID,IBATSEOS,HRTZERO,VIRTUALGO,G1XLP,VIRTUMID,GLOBALXLP,CTDLMID,TPLUS0",
9       "listingExchange": "NYSE",
10       "countryCode": "US",
11       "name": "INTL BUSINESS MACHINES CORP",
12       "assetClass": "STK",
13       "expiry": null,
14       "lastTradingDay": null,
15       "group": "Computers",
16       "putOrCall": null,
17       "sector": "Technology",
18       "sectorGroup": "Computer Services",
19       "strike": "0",
20       "ticker": "IBM",
21       "undConid": 0,
22       "multiplier": 0,
23       "type": "COMMON",
24       "hasOptions": true,
25       "fullName": "IBM",
26       "isUS": true,
27       "incrementRules": [
28         {
29           "lowerEdge": 0,
30           "increment": 0.01
31         }
32       ],
33       "displayRule": [
34         {
35           "magnification": 0,
36           "displayRuleStep": [
37             {
38               "decimalDigits": 2,
39               "lowerEdge": 0,
40               "wholeDigits": 4
41             }
42           ]
43         }
44       ],
45       "isEventContract": false
46     }
47   ]
48 }

Returns a list of security definitions for the given conids.

Query parameters

conidsstringRequired

Response

Successful response containing a contract's security definition.

secdeflist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

503

Service Unavailable Error