# Trade Every price or size values should be represented with Finery Markets internal corresponding types. A description of all the types can be found [here](https://faq.finerymarkets.com/api-reference/data-types). ## **New Order Single\** Sent by the client to submit a new order. **Execution Report<8>** sent to the client to provide information about the order execution.
TagNameRequiredExampleDescription
11ClOrdIDY123Unique identifier of the order as assigned by the client, should be integral number, >0
55SymbolYBTC-USDInstrument name
44PriceN1Price, value of type Price
38OrderQtyN1Size of the order(if the order is by size), value of type Size
152CashOrderQtyN1Volume of the order(if the order is by volume), value of type Size
40OrdTypeY1Order Type(see below)
54SideY1Side of the order(see below)
59TimeInForceY1Specifies how long the order remains in effect(see below)
60TransactTimeY20230530-09:29:52.722UTC Timestamp of the order creation
20006QsEnabledNYIf true, adds QS as potential sources of liquidity for the order execution. If false or omitted, only Firm Book is considered. Can only be used by takers.
20004FirmBookEnabledNYIf true adds Firm Book as a potential source of liquidity for the order execution. If false, only QS are considered. False by default. Taken into account only if QsEnabled<20006> == true. Can only be used by takers.
20001NoCounterpartiesN1List of LPs to consider QS from. If empty or omitted, all available LPs considered. Taken into account only if QsEnabled<20006> == True and does not affect the Firm Book execution. Can only be used by takers.
20002⇒ LpIDN1234FM id of an LP
| Order Type | Description | | :--------: | :-----------------: | | 1 | Market (Taker only) | | 2 | Limit | | Order Side | Description | | :--------: | :---------: | | 1 | Buy | | 2 | Sell | | Time In Force | Description | | :-----------: | :-------------------------------: | | 1 | Good Till Cancel (GTC) - Maker | | 3 | Immediate or Cancel (IOC) - Taker | | 4 | Fill or Kill (FOK) - Taker | | P | PostOnly - Maker | Either **OrderQty<38>** or **CashOrderQty<152>** field should present. ## **Execution Report<8>** Sent by the server whenever an order receives a fill, whenever the status of an order changes, or in response to a **NewOrderSingle\**, **OrderCancelRequest\** and **OrderCancel/Replace Request\** message from the client.
TagNameRequiredExampleDescription
37OrderIDY1Unique order Id, generated by the server
11ClOrdIDY2Unique identifier of the order as assigned by the client. ClOrdID<11> of the canceled order if OrdStatus<39> == 4 (canceled), ClOrdID<11> from the NewOrderSingle<D> or OrderCancel/ReplaceRequest<G> otherwise
151LeavesQtyY1Quantity open for further execution, value of type Size
17ExecIDN123Deal id in case of ExecType<150> == TRADE. Same as OrderID<37> otherwise.
55SymbolNBTC-USDInstrument name
54SideN1“1” - Buy, “2” - Sell
38OrderQtyN1Order quantity, value of type Size. If ExecType<150> == 5, quantity of the new order
44PriceN10Order Price, value of type Price. If ExecType<150> == 5, price of the new order
31LastPxN1000Current fill price. Only present if this message was the result of a fill, value of type Price
32LastQtyN2Current fill quantity. Only present if this message was the result of a fill, value of type Size
39OrdStatusY2Identifies current status of order(see below)
150ExecTypeY2Describes the specific Execution Report(see below)
58TextN79In case the order was declined by the Finery Markets, this field contains Finery Markets error code
136NoMiscFeesN1If present should always be 1 Following group describes markup applied to the deal
137=> MiscFeeAmtN10Required if NoMiscFees<136> is present. Markup size.
139=> MiscFeeTypeN8Required if NoMiscFees<136> is present. Should always be 8 for Markup.
958CounterpartyIDN1234FineryMarkets id of the counterparty
41OrigClOrdIDN42ClOrdID<11> of the replaced order, if ExecType<150> = 5(Replaced).
20005LiquiditySourceN'1'Liquidity source for the trade when ExecType<150> = F (Trade). Field of type CHAR. Defaults to the firm book if the tag is absent.
60TransactTimeY20230530-09:29:52.722UTC Timestamp of the Execution Report<8>
| Order Status | Description | | :----------: | :--------------: | | 0 | New | | 1 | Partially filled | | 2 | Filled | | 4 | Canceled | | 5 | Replaced | | 8 | Rejected | | Exec Type | Description | | :-------: | :---------: | | 0 | New | | F | Trade | | 4 | Canceled | | 5 | Replaced | | 8 | Rejected | | LiquiditySource | Description | | :-------------: | :-----------: | | '0' | Firm Book | | '1' | RFQ | | '2' | Quote Streams | | '3' | Not Available | **ExecType<150>** indicates the reason why the **Execution Report<8>** message was sent. And Order Status indicates the current state of the order. For every order **Execution Report<8>** with **ExecType<150>** == **0** should be generated. When no further execution is possible **Execution Report<8>** with either **ExecType<150>** == **F** and **OrderStatus<39>** == **2** or **ExecType<150>** == **4** and **OrderStatus<39>** == **4** should be generated. ## **Order Cancel Request\** The **Order Cancel Request\** message requests the cancellation of all of the remaining quantity of an existing order. Note that the **Order Cancel/Replace Request\** should be used to partially cancel (reduce) an order).
TagNameRequiredExampleDescription
37OrderIDN1Unique order Id, generated by the server, of the order to cancel
11ClOrdIDY2Unique identifier of the request as assigned by the client
41OrigClOrdIDN3ClOrdID <11> of the order to cancel
54SideY1Side of the order(see above)
60TransactTimeY20230530-09:29:52.722UTC Timestamp of the order creation
Either **OrderID<37>** or **OrigClOrdID<41>** should be present. ## **Order Cancel Reject<9>** The **Order Cancel Reject <9>** message is issued by the server upon receipt of a **Order Cancel Request\** or **Order Cancel/Replace Request\** message which cannot be honored.
TagNameRequiredExampleDescription
37OrderIDN1Unique order Id, generated by the server, copied from request message
11ClOrdIDY2Request Id assigned by the client, copied from request message
41OrigClOrdIDN3ClOrdID <11> of the previous non-rejected order, copied from request message
434CxlRejResponseToY1Identifies the type of request that a Cancel Reject <9> is in response to(see below)
102CxlRejReasonN99Reject Reason Code. If CxlRejReason == 99, Text<58> field contains FineryMarkets error code.
58TextNInvalid OrderID.Human-readable reject reason
39OrdStatusY0Reserved for future use. Always 0.
| CxlRejResponseTo | Description | | :--------------: | :-------------------------------------------: | | 1 | Order Cancel Request\ was rejected | | 2 | Order Cancel/Replace Request\ was rejected | ## **Order Cancel/Replace Request\** The **Order Cancel/Replace Request\** (a.k.a. Order Modification Request) is used to change the parameters of an existing order. Do not use this message to cancel the remaining quantity of an outstanding order, use the **Order Cancel Request\** message for this purpose. It is possible, that the "Cancel" part succeeds and "Replace" part fails. In this case ExecutionReport<8> with OrdStatus<39> == 4 (Canceled) issued for the canceled order as well as the OrderCancelReject<9> referencing the OrderCancel/ReplaceRequest\ with the "Replace" failure reason.
TagNameRequiredExampleDescription
37OrderIDY1Unique order Id, generated by the server, of the order to cancel/replace
11ClOrdIDY2Request Id assigned by the client
41OrigClOrdIDY1Request Id assigned by the client for the original order
44PriceY3Price, value of type Price
38OrderQtyY4Initial size of replace result will be OrderQty - (old order initial size - old order remaining size)
40OrdTypeY1Order Type (see above) should be the same as in the original order
54SideY1Side of the order(see above) should be the same as in the original order
60TransactTimeY20230530-09:29:52.722UTC Timestamp of the order creation