---
title: "Market Data Snapshot (Beta)"
method: GET
path: "/md/snapshot"
tags: ["Market Data"]
---

# Market Data Snapshot (Beta)

`GET /md/snapshot`

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](https://interactivebrokers.github.io/cpwebapi/RealtimeSubscription.html) for details.

## Query parameters

- `conids` 'conid@exchange:instrType', required
- `fields` string

## Response `200`

An Object

- MarketData
  - `31` string — 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.
  - `70` number — High - Current day high price
  - `71` number — Low - Current day low price
  - `82` string — Change - The difference between the last price and the close on the previous trading day
  - `83` number — Change % - The difference between the last price and the close on the previous trading day in percentage.
  - `84` string — Bid Price - The highest-priced bid on the contract.
  - `85` string — Ask Size - The number of contracts or shares offered at the ask price. For US stocks, the number displayed is divided by 100.
  - `86` string — Ask Price - The lowest-priced offer on the contract.
  - `87` string — Volume - Volume for the day, formatted with 'K' for thousands or 'M' for millions. For higher precision volume refer to field 7762.
  - `88` string — Bid Size - The number of contracts or shares bid for at the bid price. For US stocks, the number displayed is divided by 100.
  - `6509` string — 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.
  - `7057` string — 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
  - `7058` string — 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
  - `7059` number — Last Size - The number of unites traded at the last price
  - `7068` string — 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
  - `7195` string — IV Rank
  - `7196` string — IV Rank
  - `7197` string — IV Rank
  - `7198` string — IV Percentile
  - `7199` string — IV Percentile
  - `7200` string — IV Percentile
  - `7201` string — IV High Low
  - `7202` string — IV High Low
  - `7203` string — IV High Low
  - `7204` string — IV High Low
  - `7205` string — IV High Low
  - `7206` string — IV High Low
  - `7207` string — HV Rank
  - `7208` string — HV Rank
  - `7209` string — HV Rank
  - `7210` string — HV Percentile
  - `7211` string — HV Percentile
  - `7212` string — HV Percentile
  - `7245` string — HV High Low
  - `7246` string — HV High Low
  - `7247` string — HV High Low
  - `7248` string — HV High Low
  - `7249` string — HV High Low
  - `7263` string — HV High Low
  - `7264` string — ESG
  - `7265` string — ESG
  - `7266` string — ESG
  - `7267` string — ESG
  - `7268` string — ESG
  - `7269` string — ESG
  - `7271` string — ESG
  - `7272` string — ESG
  - `7273` string — ESG
  - `7274` string — ESG
  - `7275` string — ESG
  - `7276` string — ESG
  - `7277` string — ESG
  - `7282` string — Average Volume - The average daily trading volume over 90 days.
  - `7283` string — 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.
  - `7284` string — Historic Volume (30d)
  - `7286` number — Dividend Amount - Displays the amount of the next dividend.
  - `7287` string — 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.
  - `7288` string — Ex-date of the dividend
  - `7289` string — Market Cap
  - `7290` string — P/E
  - `7293` string — 52 Week High - The highest price for the past 52 weeks.
  - `7294` string — 52 Week Low - The lowest price for the past 52 weeks.
  - `7295` number — Open - Today's opening price.
  - `7296` number — Close - Today's closing price.
  - `7331` string — Reuters Fundamentals
  - `7370` string — ESG
  - `7371` string — ESG
  - `7372` string — ESG
  - `7635` string — 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
  - `7636` number — shortable invetory
  - `7637` string — Fee rebate rate
  - `7644` string — Shortable - Describes the level of difficulty with which the security can be sold short.
  - `7674` string — EMA(200) - Exponential moving average (N=200).
  - `7675` string — EMA(100) - Exponential moving average (N=100).
  - `7676` string — EMA(50) - Exponential moving average (N=50).
  - `7677` string — EMA(20) - Exponential moving average (N=20).
  - `7681` string — Price/EMA(20) - Price to Exponential moving average (N=20) ratio -1, displayed in percents.
  - `7698` string — 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.
  - `7699` string — 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.
  - `7718` string — Beta - Beta is against standard index.
  - `7720` string — 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.
  - `7743` string — Reuters Fundamentals
  - `7761` string — ESG
  - `7992` string — 26 Week High - The highest price for the past 26 weeks.
  - `7993` string — 26 Week Low - The lowest price for the past 26 weeks.
  - `7994` string — 13 Week High - The highest price for the past 13 weeks.
  - `7995` string — 13 Week Low - The lowest price for the past 13 weeks.
  - `conid` integer — IBKR Contract identifier
  - `minTick` number — minimum price increment
  - `BboExchange` string — Color for Best Bid/Offer Exchange in hex code
  - `HasDelayed` boolean — If market data field values return delayed
  - `sizeMinTick` integer — minimum size increment
  - `BestEligible` integer
  - `BestBidExch` integer
  - `BestAskExch` integer
  - `PreOpenBid` integer
  - `LastAttribs` integer
  - `TimestampBase` integer — Base time stamp for last update in format YYYYMMDD
  - `TimestampDelta` integer
  - `LastExch` integer
  - `CloseAttribs` integer

## Other responses

- `401` — Authentication failed
- `500` — System failed

---

[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)