---
title: "Market Data Snapshot"
method: GET
path: "/marketdata/snapshot"
tags: ["Market Data"]
---

# Market Data Snapshot

`GET /marketdata/snapshot`

This endpoint allows the consumer to request a market data snapshot for one or more trading products. 
Consumers need to provide unique identifiers (conids) for the products in the IB product database (retrievable using the /secdef endpoint). The 'market' values are integers whose bits indicate the exchange(s) making up the quote. 

The mapping of bit to exchange is obtained from the marketdata/exchange_component endpoint. For example, if a bid has a 'market' value of 5 and the exchange_component result has the map 
0 => NYSE, 1 => ISLAND, 2 => ARCA then the exchanges contributing to the bid size are NYSE and ARCA. 

Similarly, if market=2, then only ISLAND is contributing.

## 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[]
  - `Conid` string
  - `Temporality` 0 | 1 — 0 = Real time data 1 = Delayed data
  - `Complete` boolean
  - `Trade` object
    - `market` number
    - `price` number
    - `size` number
    - `time` number
  - `Closing` object
    - `price` number
  - `Bid` object
    - `market` number
    - `price` number
    - `size` number
  - `Offer` object
    - `market` number
    - `price` number
    - `size` number

## Other responses

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