# Market Data Every price or size values should be represented with FineryMarkets internal corresponding types. Description of all the types can be found [here](https://faq.finerymarkets.com/api-reference/data-types). ## Market Data Request\ Market data request allows receiving market data on a subscription basis.

Tag	Name	Required	Example	Description
262	MDReqID	Y	1	Unique market data request Id
263	SubscriptionRequestType	Y	2	Subscription request type(see below)
267	NoMDEntryTypes	Y	2	Number of MDEntryType <269> fields requested. Should always be 2 for bid and offer.
269	=> MDEntryType	Y	0	Must be the first field in this repeating group. This is a list of all the types of Market Data Entries that the firm requesting the Market Data is interested in receiving (see below)
146	NoRelatedSym	Y	1	Number of symbols (instruments) requested. Should be 1.
55	=> Symbol	Y	BTC-USD	Requested instrument

| Subscription Request Type | Description | | :-----------------------: | :---------: | | 1 | Subscribe | | 2 | Unsubscribe | | MDEntryType | Description | | :---------: | :---------: | | 0 | Bid | | 1 | Offer | Upon a successful subscription, a **Market Data - Snapshot/Full Refresh \** message is sent to the client, followed by subsequent **Snapshot/Full Refresh \** messages for each book update. If the subscription fails, a **Market Data Request Reject \** message is sent to the client. ## **Market Data - Snapshot/Full Refresh\** Market Data messages are used as the response to a **Market Data Request\** message. In all cases, one Market Data message refers only to one **Market Data Request\** . Each Market Data message contains information about only one symbol (instrument).

Tag	Name	Required	Example	Description
262	MDReqID	Y	1	Contains MDReqId<262> from corresponding Market Data Request
55	Symbol	Y	BTC-USD	Instrument
268	NoMDEntries	Y	1	Number of entries following. 0 for empty book.
269	=> MDEntryType	Y	0	Must be the first field of the repeating group. Entry type(see below)
270	=> MDEntryPx	Y	1	Price, value of type Price
271	=> MDEntrySize	Y	1	Size, value of type Size
20002	LpId	Y	123	FM id of an LP, providing the corresponding price stream

| MDEntryType | Description | | :---------: | :---------: | | 0 | Bid | | 1 | Offer |

Example of the message

{% code overflow="wrap" lineNumbers="true" %} ``` 8=FIX.4.4|9=471|35=W|34=2|49=FINERYMARKETS|52=20250526-14:33:53.914|56=|55=BTC-USD|262=1|268=10|269=0|270=500000000|271=500000000|269=0|270=400000000|271=400000000|269=0|270=300000000|271=300000000|269=0|270=200000000|271=200000000|269=0|270=100000000|271=100000000|269=1|270=100000000|271=100000000|269=1|270=200000000|271=200000000|269=1|270=300000000|271=300000000|269=1|270=400000000|271=400000000|269=1|270=500000000|271=500000000|20002=1|10=102 ``` {% endcode %}

## **Market Data - Reject \** The **Market Data Request Reject\** is used when FineryMarkets cannot honor the **Market Data Request\** , due to business or technical reasons.

Tag	Name	Required	Example	Description
262	MDReqID	Y	1	Contains MDReqId<262> from corresponding Market Data Request
281	MDReqRejReason	N	0	Rejection reason code(see below)
58	Text	N	25	Contains FM error code if MDReqRejReason<281> == F

| Rejection reason code | Description | | :-------------------: | :----------------------------------------------: | | 0 | Unknown symbol(instrument) | | 3 | Insufficient Permissions | | 4 | Unsupported SubscriptionRequestType <263> | | F | Finery Markets error, see code in Text<58> field | | A | Finery Markets error, see code in Text<58> field |