Market Data Snapshot (Beta)
Get a snapshot of Market Data for the given conid(s).See response for a list of available fields that can be requested from the fields argument. Must be connected to a brokerage session before can query snapshot data. First /snapshot endpoint call for given conid(s) will initiate the market data request, make an additional request to receive field values back. To receive all available fields the /snapshot endpoint will need to be called several times. To receive streaming market data the endpoint /ws can be used. Refer to Streaming WebSocket Data for details.
Query parameters
List of conids comma separated. Optional exchange and instrument type can be specified.
- conid: IBKR Contract Identifier
- exchange: Exchange or venue
- instrType: Instrument Type supported values: CS (Stocks), OPT (Options), FUT (Futures), FOP (Future Options), WAR (Warrants), BOND (Bonds), FUND (Mutual Funds), CASH (Forex), CFD (Contract for difference), IND (Index)
list of fields separated by comma
Response
An Object
Last Price - The last price at which the contract traded. May contain one of the following prefixes:
- C - Previous day's closing price.
- H - Trading has halted.
High - Current day high price
Low - Current day low price
Change - The difference between the last price and the close on the previous trading day
Change % - The difference between the last price and the close on the previous trading day in percentage.
Bid Price - The highest-priced bid on the contract.
Ask Size - The number of contracts or shares offered at the ask price. For US stocks, the number displayed is divided by 100.
Ask Price - The lowest-priced offer on the contract.
Volume - Volume for the day, formatted with 'K' for thousands or 'M' for millions. For higher precision volume refer to field 7762.
Bid Size - The number of contracts or shares bid for at the bid price. For US stocks, the number displayed is divided by 100.
Market Data Availability. The field may contain three chars. First char defines: R = RealTime, D = Delayed, Z = Frozen, Y = Frozen Delayed, N = Not Subscribed. Second char defines: P = Snapshot, p = Consolidated. Third char defines: B = Book
- RealTime - Data is relayed back in real time without delay, market data subscription(s) are required.
- Delayed - Data is relayed back 15-20 min delayed.
- Frozen - Last recorded data at market close, relayed back in real time.
- Frozen Delayed - Last recorded data at market close, relayed back delayed.
- Not Subscribed - User does not have the required market data subscription(s) to relay back either real time or delayed data.
- Snapshot - Snapshot request is available for contract.
- Consolidated - Market data is aggregated across multiple exchanges or venues.
- Book - Top of the book data is available for contract.
Ask Exch - Displays the exchange(s) offering the SMART price. A=AMEX, C=CBOE, I=ISE, X=PHLX, N=PSE, B=BOX, Q=NASDAQOM, Z=BATS, W=CBOE2, T=NASDAQBX, M=MIAX, H=GEMINI, E=EDGX, J=MERCURY
Last Exch - Displays the exchange(s) offering the SMART price. A=AMEX, C=CBOE, I=ISE, X=PHLX, N=PSE, B=BOX, Q=NASDAQOM, Z=BATS, W=CBOE2, T=NASDAQBX, M=MIAX, H=GEMINI, E=EDGX, J=MERCURY
Last Size - The number of unites traded at the last price
Bid Exch - Displays the exchange(s) offering the SMART price. A=AMEX, C=CBOE, I=ISE, X=PHLX, N=PSE, B=BOX, Q=NASDAQOM, Z=BATS, W=CBOE2, T=NASDAQBX, M=MIAX, H=GEMINI, E=EDGX, J=MERCURY
IV Rank
IV Rank
IV Rank
IV Percentile
IV Percentile
IV Percentile
IV High Low
IV High Low
IV High Low
IV High Low
IV High Low
IV High Low
HV Rank
HV Rank
HV Rank
HV Percentile
HV Percentile
HV Percentile
HV High Low
HV High Low
HV High Low
HV High Low
HV High Low
HV High Low
ESG
ESG
ESG
ESG
ESG
ESG
ESG
ESG
ESG
ESG
ESG
ESG
ESG
Average Volume - The average daily trading volume over 90 days.
Option Implied Vol. % - A prediction of how volatile an underlying will be in the future. At the market volatility estimated for a maturity thirty calendar days forward of the current trading day, and based on option prices from two consecutive expiration months.
Historic Volume (30d)
Dividend Amount - Displays the amount of the next dividend.
Dividend Yield % - This value is the toal of the expected dividend payments over the next twelve months per share divided by the Current Price and is expressed as a percentage. For derivatives, this displays the total of the expected dividend payments over the expiry date.
Ex-date of the dividend
Market Cap
P/E
52 Week High - The highest price for the past 52 weeks.
52 Week Low - The lowest price for the past 52 weeks.
Open - Today's opening price.
Close - Today's closing price.
Reuters Fundamentals
ESG
ESG
ESG
Mark - The mark price is, the ask price if ask is less than last price, the bid price if bid is more than the last price, otherwise it's equal to last price
shortable invetory
Fee rebate rate
Shortable - Describes the level of difficulty with which the security can be sold short.
EMA(200) - Exponential moving average (N=200).
EMA(100) - Exponential moving average (N=100).
EMA(50) - Exponential moving average (N=50).
EMA(20) - Exponential moving average (N=20).
Price/EMA(20) - Price to Exponential moving average (N=20) ratio -1, displayed in percents.
Last Yield - Implied yield of the bond if it is purchased at the current last price. Last yield is calculated using the Last price on all possible call dates. It is assumed that prepayment occurs if the bond has call or put provisions and the issuer can offer a lower coupon rate based on current market rates. The yield to worst will be the lowest of the yield to maturity or yield to call (if the bond has prepayment provisions). Yield to worse may be the same as yield to maturity but never higher.
Bid Yield - Implied yield of the bond if it is purchased at the current bid price. Bid yield is calculated using the Ask on all possible call dates. It is assumed that prepayment occurs if the bond has call or put provisions and the issuer can offer a lower coupon rate based on current market rates. The yield to worst will be the lowest of the yield to maturity or yield to call (if the bond has prepayment provisions). Yield to worse may be the same as yield to maturity but never higher.
Beta - Beta is against standard index.
Ask Yield - Implied yield of the bond if it is purchased at the current offer. Ask yield is calculated using the Bid on all possible call dates. It is assumed that prepayment occurs if the bond has call or put provisions and the issuer can offer a lower coupon rate based on current market rates. The yield to worst will be the lowest of the yield to maturity or yield to call (if the bond has prepayment provisions). Yield to worse may be the same as yield to maturity but never higher.
Reuters Fundamentals
ESG
26 Week High - The highest price for the past 26 weeks.
26 Week Low - The lowest price for the past 26 weeks.
13 Week High - The highest price for the past 13 weeks.
13 Week Low - The lowest price for the past 13 weeks.
IBKR Contract identifier
minimum price increment
Color for Best Bid/Offer Exchange in hex code
If market data field values return delayed
minimum size increment
Base time stamp for last update in format YYYYMMDD
Changes
No recorded changes to this endpoint across all 1 revision of this API.