Coinbase Derivatives: Predictions FIX Order Entry Messages

The Coinbase Derivatives: Predictions FIX Order Entry API lets you submit and cancel orders, receive execution and settlement reports, and recover missed fills over FIX 5.0 SP2.

Order Entry Message Types

The Coinbase Derivatives: Predictions Order Entry FIX API supports the following message and execution types. For Logon, heartbeats, sequence recovery, and fill recovery, see Session.

Client Message Types

NewOrderSingle (35=D): Submits a new limit or market order.
OrderCancelRequest (35=F): Cancels one open order.
OrderMassCancelRequest (35=q): Cancels multiple open orders.

System Message and Execution Types

ExecutionReport (35=8): Reports order lifecycle events. Execution types are:
- Pending New (150=A): Order accepted and held for the instrument’s speed bump delay.
- New (150=0): Order accepted.
- Trade (150=F): Order partially or fully filled.
- Canceled (150=4): Order canceled by request or by the exchange.
- Expired (150=C): IOC remainder or FOK that could not fill.
- Rejected (150=8): Order rejected by the exchange.
OrderCancelReject (35=9): Rejection of an OrderCancelRequest.
OrderMassCancelReport (35=r): Result of an OrderMassCancelRequest.
MarketSettlementReport (35=UMS): Firm position payout when an instrument settles.
BusinessMessageReject (35=j): Rejection not reportable with an ExecutionReport.

Fill Recovery Message Types

Documented on Session, shared with drop copy:

LastExecIDRequest (35=F1): Client request for the ExecID of your newest fill.
LastExecID (35=F2): System response to F1.
EventResendRequest (35=F3): Client request to replay fills in an ExecID range.
EventResendComplete (35=F4): System response to a successful F3 request.
EventResendReject (35=F5): System response to an unsuccessful F3 request.

Session Message Types

Logon (35=A), Logout (35=5), Heartbeat (35=0), TestRequest (35=1), ResendRequest (35=2), Reject (35=3), and SequenceReset (35=4). See Session.

Connection

Connect with TargetCompID (56) = CPMOE and your API key in SenderCompID (49). The API key must have the TRADE permission. Host and port are listed on the Coinbase Derivatives: Predictions Connectivity page. Header fields are on Header/Trailer. Logon, the Logon signature, heartbeats, sequence recovery, and cancel on disconnect are on Session. SendingTime (52) and TransactTime (60) on messages you receive are UTC timestamps with microsecond precision. For a read-only copy of your executions, use FIX Drop Copy. For order books and public trades, use FIX Market Data.

Prices, quantities, and sides

Prices, quantities, and amounts are FIX decimal values, not scaled integers.

Field type	Decimal places	Tags	Notes
Price	3	44, 31, 6, 730	YES price in USDC. Order prices range from `0.001` to `0.999`.
Quantity	2	38, 32, 14, 151, 21054, 21055	Contracts. Minimum increment `0.01`.
Amount	6	137, 21009, 21056	USDC.

Inbound values may carry fewer decimal places than the maximum. Extra decimal places are truncated toward zero, not rejected. For example, 44=0.6505 is read as 0.650. Range checks apply after truncation.
Side (54) always refers to the YES contract. 1 = Buy YES. 2 = Sell YES. There is no separate NO side on FIX. To buy NO at price P, sell YES at 1.000 - P. To sell NO at price P, buy YES at 1.000 - P.
A YES price of 0.650 implies a probability of about 65%. YES price plus NO price equals 1.000.

Identifiers

OrderID (37), ExecID (17), TrdMatchID (880), MassActionReportID (1369), and MarketSettlementReportID (20105) are String fields that contain the decimal form of a 64-bit integer.

Store them as strings or 64-bit integers. They exceed the range of a 32-bit integer.
Echo OrderID (37) exactly as received on OrderCancelRequest (35=F).
ExecID, MassActionReportID, and MarketSettlementReportID share one increasing number space. Compare them numerically to order events. Values are not consecutive.
0 is a sentinel where no identifier exists, as described on each field.

ClOrdID (11), OrigClOrdID (41), and the sub-account PartyID (448) accept exactly two forms:

At most 18 printable ASCII characters (0x20 to 0x7E).
A 36-character lowercase hyphenated UUID (8-4-4-4-12, IETF variant 2).

Any other value is rejected with BusinessMessageReject (35=j), for example 19 to 35 characters, an uppercase UUID, 32-character hex, or a URN. Values are never truncated. ClOrdID also rejects UUIDs of the form 80000000-0000-0000-xxxx-xxxxxxxxxxxx.

NewOrderSingle (35=D)

Submits a new limit or market order. Problems detectable from the request alone are answered immediately with BusinessMessageReject (35=j) and no ExecutionReport follows. All other outcomes are reported with ExecutionReport (35=8).

Tag	Name	FIX Type	Req	Description
11	ClOrdID	String	Y	Client order ID, unique among your live orders. See Identifiers for the accepted forms.
55	Symbol	String	Y	Instrument ticker. Must match a listed instrument exactly. An unknown ticker is rejected with `Text (58) = unknown Symbol`.
54	Side	Char	Y	`1` = Buy YES. `2` = Sell YES. See Prices, quantities, and sides.
38	OrderQty	Qty	Y	Order quantity in contracts, 2 decimal places.
44	Price	Price	C	Limit price, 3 decimal places, from `0.001` to `0.999`. Required when `40=2`. Must not be sent when `40=1`.
40	OrdType	Char	Y	`1` = Market. `2` = Limit. A market order is priced at the worst admissible price (`0.999` for buy, `0.001` for sell) and runs as IOC.
59	TimeInForce	Char	N	`1` = GTC (default). `3` = IOC. `4` = FOK.
18	ExecInst	MultipleCharValue	N	Post-only mode. `6` = Post only: adjust the price so the order does not cross. `A` = Post only, reject if the order would cross. Space-delimited. If both are sent, the order is treated as `A`. Other values are ignored.
7928	SelfMatchPreventionId	Int	N	Self-match prevention ID. Must equal the ID registered for your user. See Self-match prevention.
8000	SelfMatchPreventionStrategy	Char	N	`N` = Cancel aggressing. `O` = Cancel resting. `Q` = Cancel both. See Self-match prevention.
1028	ManualOrderIndicator	Boolean	Y	CFTC Rule 1.35 audit flag. `Y` = Entered manually. `N` = Generated automatically.
21009	MaxExecutionCost	Amt	N	All-in spend cap in USDC, 6 decimal places. FOK only. See Max execution cost.
453	NoPartyIDs	NumInGroup	Y	Parties repeating group. Must contain the sub-account.
→ 448	PartyID	String	N	With `452=24`: the sub-account, in one of the forms listed in Identifiers. With `452=1`: the numeric executing firm ID, as a positive decimal with no leading zeros.
→ 452	PartyRole	Int	N	`24` = Customer account (sub-account). Exactly one entry is required, with a non-empty PartyID. `1` = Executing firm. See Executing firm. Other roles are ignored.

Order type and price rules

Request	Result
`40=2` without `44`	BusinessMessageReject, `Text (58) = INVALID_FIELD_VALUE: Price(44) is required for OrdType(40)=LIMIT(2)`
`40=1` with `44`	BusinessMessageReject, `Text (58) = INVALID_FIELD_VALUE: Price(44) must not be set for OrdType(40)=MARKET(1)`
`40=1` with `18=6` or `18=A`	BusinessMessageReject, `Text (58) = POST_ONLY_WOULD_CROSS: ExecInst(18) post-only is not compatible with a market order`
No `452=24` entry, or an empty sub-account	BusinessMessageReject, `Text (58) = INVALID_SUBACCOUNT: Parties with PartyRole=24 (CUSTOMER_ACCOUNT) is required`
Trading is locked for your API key, firm, or FCM	BusinessMessageReject, `Text (58) = USER_TRADING_LOCKED`

A new sub-account string is not itself an error. The sub-account is created on first use.

Executing firm

PartyRole (452) = 1 selects the firm the order is placed for.

API key scoped to a firm: optional. If sent, it must equal your firm’s ID.
API key scoped to an FCM: exactly one entry is required, naming an active firm under your FCM.

Violations are rejected with BusinessMessageReject. Text (58) is one of FCM-scoped principal requires exactly one EXECUTING_FIRM, duplicate Parties entry with PartyRole=1 (EXECUTING_FIRM), EXECUTING_FIRM is outside authenticated Firm scope, EXECUTING_FIRM is outside authenticated FCM scope, EXECUTING_FIRM is unknown or inactive, or a PartyID format error.

Max execution cost

MaxExecutionCost (21009) caps the total cost of an FOK order: the cost of the fills plus the taker fee. A buy costs the YES price times quantity. A sell costs 1.000 - price times quantity.

Condition	Result
`21009` with `TimeInForce (59)` other than `4`	BusinessMessageReject, `Text (58) = INVALID_TIME_IN_FORCE: MaxExecutionCost(21009) requires TimeInForce(59)=FOK`
`21009` zero or negative	BusinessMessageReject, `Text (58) = INVALID_FIELD_VALUE: MaxExecutionCost(21009) must be positive`
Projected cost exceeds the cap	Rejected ExecutionReport: `150=8`, `39=8`, `103=3`, `Text (58) = MAX_EXECUTION_COST_EXCEEDED - insufficient liquidity`. Nothing executes.

A cap breach is reported as Rejected (39=8). An FOK that cannot fill its full quantity is reported as Expired (39=C). Handle both terminal statuses for FOK orders, and branch on OrdStatus (39), not Text (58).

MaxExecutionCost (21009) is not echoed on execution reports.

Self-match prevention

Self-match prevention stops your orders from trading against each other. There are two independent checks:

Firm level: applies when the aggressing and resting orders have the same firm and the same sub-account, and your firm has a self-match prevention strategy configured. No tags are needed on the order.
ID based: applies when both orders carry the same positive SelfMatchPreventionId (7928). The aggressing order’s strategy applies: the 8000 you sent, otherwise the default configured for your user or firm, otherwise O.

If 7928 does not equal the ID registered for your user, the order is rejected with 103=99 and Text (58) = INVALID_FIELD_VALUE. Omit 7928 to opt out of ID-based prevention for an order.

SelfMatchPreventionStrategy (8000)	Effect
`N` = Cancel aggressing	The incoming order is canceled. The resting order stays on the book.
`O` = Cancel resting	The resting order is canceled. The incoming order continues matching.
`Q` = Cancel both	Both orders are canceled.

A self-match prevention cancel is reported as Canceled with 378=7 and Text (58) = SELF_MATCH_PREVENTION. On an FOK order, a strategy that would cancel the incoming order makes the order expire with FOK_NOT_FILLED.

OrderCancelRequest (35=F)

Cancels the remaining quantity of one open order. Identify the order by OrderID (37) or OrigClOrdID (41). You can cancel by OrigClOrdID before you receive an ExecutionReport for the order.

Tag	Name	FIX Type	Req	Description
11	ClOrdID	String	Y	New client ID for this cancel request. Same forms as `ClOrdID` on NewOrderSingle.
41	OrigClOrdID	String	C	`ClOrdID` of the order to cancel. Required if `OrderID (37)` is absent.
37	OrderID	String	C	Exchange order ID, echoed from the ExecutionReport. Required if `OrigClOrdID (41)` is absent. Takes precedence when both are sent.
55	Symbol	String	Y	Instrument ticker. Not used to locate the order.
54	Side	Char	Y	`1` = Buy. `2` = Sell. Not used to locate the order.
1028	ManualOrderIndicator	Boolean	Y	CFTC Rule 1.35 audit flag for this cancel.

A request with neither 37 nor 41 is rejected with BusinessMessageReject, Text (58) = OrderID(37) or OrigClOrdID(41) required. Each accepted request is answered by exactly one of:

Canceled ExecutionReport (150=4). Fills that happened before the cancel took effect are reported first.
OrderCancelReject (35=9).

OrderMassCancelRequest (35=q)

Cancels multiple open orders of your API key. Filters combine with AND.

Tag	Name	FIX Type	Req	Description
11	ClOrdID	String	Y	Client ID for this request. Same forms as `ClOrdID` on NewOrderSingle.
530	MassCancelRequestType	Char	Y	`1` = Cancel orders for one instrument (requires `55`). `6` = Cancel orders for the trading session. `7` = Cancel all orders. `6` and `7` behave the same: your API key has one session. Other values are rejected.
55	Symbol	String	C	Instrument ticker. Required when `530=1`. Ignored otherwise.
54	Side	Char	N	`1` = Buy only. `2` = Sell only. Omit for both sides.
453	NoPartyIDs	NumInGroup	N	Optional sub-account filter.
→ 448	PartyID	String	N	Sub-account. An empty value applies no filter.
→ 452	PartyRole	Int	N	`24` = Customer account. Other roles are ignored.

Each canceled order is reported with a Canceled ExecutionReport, Text (58) = USER_MASS_CANCEL. Then one OrderMassCancelReport (35=r) summarizes the result. Mass cancel requests are not subject to the session rate throttle.

ExecutionReport (35=8)

Reports order lifecycle events. ExecType (150) identifies the event. Fields common to all execution types:

Tag	Name	FIX Type	Req	Description
11	ClOrdID	String	Y	Client order ID. On a cancel you requested, the cancel request’s `ClOrdID`.
41	OrigClOrdID	String	N	The order’s `ClOrdID`. Sent only on a cancel you requested with OrderCancelRequest.
37	OrderID	String	Y	Exchange order ID. See Identifiers.
17	ExecID	String	Y	Exchange ID of this report. Unique per report. The handle for F1 and F3.
150	ExecType	Char	Y	`A` = Pending new. `0` = New. `F` = Trade. `4` = Canceled. `C` = Expired. `8` = Rejected.
39	OrdStatus	Char	Y	`A` = Pending new. `0` = New. `1` = Partially filled. `2` = Filled. `4` = Canceled. `C` = Expired. `8` = Rejected.
55	Symbol	String	Y	Instrument ticker. `deleted_instrument` when the instrument is no longer available.
54	Side	Char	Y	`1` = Buy YES. `2` = Sell YES.
38	OrderQty	Qty	N	Order quantity.
44	Price	Price	N	Order price. For a market order, the worst admissible price the order was given.
40	OrdType	Char	N	`1` = Market. `2` = Limit. The type you submitted.
59	TimeInForce	Char	N	`1` = GTC. `3` = IOC. `4` = FOK. A market order shows `3`.
18	ExecInst	MultipleCharValue	N	`6` or `A`. Omitted when the order is not post-only.
7928	SelfMatchPreventionId	Int	N	The ID you sent. Omitted if you sent none.
8000	SelfMatchPreventionStrategy	Char	N	The strategy that applies to the order: the one you sent, otherwise your user or firm default. Omitted if none is set. Does not report which strategy fired on a match.
1028	ManualOrderIndicator	Boolean	Y	The order’s audit flag. On a cancel, the original order’s flag.
880	TrdMatchID	String	N	Trade match ID. Trade reports only.
1057	AggressorIndicator	Boolean	N	`Y` = Aggressor (taker). `N` = Passive (maker). Trade reports only.
151	LeavesQty	Qty	Y	Open quantity remaining. `0` when the order is closed.
14	CumQty	Qty	Y	Total filled quantity.
6	AvgPx	Price	N	Average fill price.
32	LastQty	Qty	N	Quantity of this fill. Trade reports only.
31	LastPx	Price	N	YES price of this fill. Trade reports only.
136	NoMiscFees	NumInGroup	N	Fee group, one entry. Trade reports only.
→ 137	MiscFeeAmt	Amt	N	Fee in USDC, 6 decimal places. Positive = fee. Negative = rebate.
→ 138	MiscFeeCurr	Currency	N	`USDC`
→ 139	MiscFeeType	Int	N	`4` = Exchange fees.
60	TransactTime	UTCTimestamp	Y	Exchange event time, microsecond precision.
378	ExecRestatementReason	Int	N	Reason for an exchange-initiated cancel. See Canceled.
103	OrdRejReason	Int	N	Rejected reports only. See OrdRejReason values.
58	Text	String	N	Reject or cancel reason label.
453	NoPartyIDs	NumInGroup	N	Always 5 entries in the order below. A value that cannot be resolved is sent as `unknown`.
→ 452	PartyRole	Int	N	`4` = Clearing firm. `1` = Executing firm. `24` = Customer account. `11` = Order origination trader. `55` = Session ID.
→ 448	PartyID	String	N	For `452=4`: FCM code. `452=1`: firm code. `452=24`: sub-account. `452=11`: trading user name. `452=55`: API key.

Pending New (35=8, 150=A)

Sent when an order is accepted on an instrument with a speed bump. The order is not yet matchable. A further report follows when the delay ends.

Tag	Name	FIX Type	Req	Description
150	ExecType	Char	Y	`A` = Pending new.
39	OrdStatus	Char	Y	`A` = Pending new.
151	LeavesQty	Qty	Y	Order quantity.
14	CumQty	Qty	Y	`0.00`
6	AvgPx	Price	N	`0.000`

New (35=8, 150=0)

Confirms that an order was accepted.

Tag	Name	FIX Type	Req	Description
150	ExecType	Char	Y	`0` = New.
39	OrdStatus	Char	Y	`0` = New.
151	LeavesQty	Qty	Y	Order quantity.
14	CumQty	Qty	Y	`0.00`
6	AvgPx	Price	N	`0.000`

Trade (35=8, 150=F)

Reports a fill. Each fill produces one report per side. Fills trade at the resting order’s price.

Tag	Name	FIX Type	Req	Description
150	ExecType	Char	Y	`F` = Trade.
39	OrdStatus	Char	Y	`1` = Partially filled. `2` = Filled.
32	LastQty	Qty	N	Always sent. Quantity of this fill.
31	LastPx	Price	N	Always sent. YES price of this fill.
151	LeavesQty	Qty	Y	Open quantity after this fill.
14	CumQty	Qty	Y	Total filled quantity.
6	AvgPx	Price	N	Always sent. Average fill price.
880	TrdMatchID	String	N	Always sent. Trade match ID. The same on both sides of the trade.
1057	AggressorIndicator	Boolean	N	Always sent. `Y` = Aggressor. `N` = Passive.
136	NoMiscFees	NumInGroup	N	Always sent. `1`
→ 137	MiscFeeAmt	Amt	N	Fee in USDC. Negative = rebate.
→ 138	MiscFeeCurr	Currency	N	`USDC`
→ 139	MiscFeeType	Int	N	`4` = Exchange fees.

Trade reports are the only reports that EventResendRequest (35=F3) can replay.

Canceled (35=8, 150=4)

Confirms that an order was canceled, at your request or by the exchange.

Cancel you requested with OrderCancelRequest: ClOrdID (11) is the cancel request’s ClOrdID, and OrigClOrdID (41) is the order’s ClOrdID. 378 is not sent.
Exchange-initiated cancel (mass cancel, self-match prevention, instrument status change, cancel on disconnect, or exchange operations): ClOrdID (11) is the order’s ClOrdID. 41 is not sent.

Tag	Name	FIX Type	Req	Description
150	ExecType	Char	Y	`4` = Canceled.
39	OrdStatus	Char	Y	`4` = Canceled.
38	OrderQty	Qty	N	Canceled quantity plus filled quantity.
151	LeavesQty	Qty	Y	`0.00`
14	CumQty	Qty	Y	Total filled quantity.
6	AvgPx	Price	N	`0.000` when the order had no fills. Omitted when it had fills; use `AvgPx` from the last Trade report.
378	ExecRestatementReason	Int	N	Exchange-initiated cancels only. `7` = Self-match prevention. `2` = Instrument closed, paused, or determined. `1` = Cancel on disconnect. `105` = Canceled by exchange operations. Not sent for mass cancels.
58	Text	String	N	Always sent. Cancel reason label, for example `USER_REQUEST`, `USER_MASS_CANCEL`, `SELF_MATCH_PREVENTION`, `CLIENT_DISCONNECT`, `ADMIN_CANCEL`, `INSTRUMENT_CLOSED`.

Expired (35=8, 150=C)

Sent in two cases:

IOC remainder: the unfilled quantity of an IOC or market order is removed after matching. Text (58) = TIME_IN_FORCE. If you cancel such an order yourself, you receive Canceled instead.
FOK that cannot fill: the full quantity is not available, so nothing executes. Text (58) starts with FOK_NOT_FILLED.

Tag	Name	FIX Type	Req	Description
150	ExecType	Char	Y	`C` = Expired.
39	OrdStatus	Char	Y	`C` = Expired.
151	LeavesQty	Qty	Y	`0.00`
14	CumQty	Qty	Y	Total filled quantity. Always `0.00` for an FOK.
6	AvgPx	Price	N	`0.000` when there were no fills. Omitted when an IOC had fills.
58	Text	String	N	Always sent. `TIME_IN_FORCE`, or `FOK_NOT_FILLED` followed by `-` and a detail.

OrdRejReason (103) is never sent on an Expired report.

Rejected (35=8, 150=8)

Reports that the exchange rejected an order after accepting the message.

Tag	Name	FIX Type	Req	Description
150	ExecType	Char	Y	`8` = Rejected.
39	OrdStatus	Char	Y	`8` = Rejected.
151	LeavesQty	Qty	Y	`0.00`
14	CumQty	Qty	Y	`0.00`
6	AvgPx	Price	N	`0.000`
103	OrdRejReason	Int	N	Always sent. See OrdRejReason values.
58	Text	String	N	Always sent. Reason label, optionally followed by `-` and a detail.

OrdRejReason values

Branch on OrdStatus (39) and OrdRejReason (103). Text (58) labels are more specific but are for logging and diagnosis. New labels can be added, and a label can move to a different 103 value.

OrdRejReason (103)	Meaning	Text (58) labels
`1`	Unknown symbol	`INVALID_INSTRUMENT`
`3`	Order exceeds limit	`MAX_ORDER_SIZE_EXCEEDED`, `MAX_ACTIVE_ORDERS_EXCEEDED`, `MAX_EXECUTION_COST_EXCEEDED`
`6`	Duplicate order	`DUPLICATE_CLIENT_ORDER_ID`
`11`	Unsupported order characteristic	`INVALID_TIME_IN_FORCE`, `POST_ONLY_WOULD_CROSS`
`13`	Incorrect quantity	`INVALID_QUANTITY`
`15`	Unknown account	`INVALID_SUBACCOUNT`
`16`	Price exceeds band	`INVALID_PRICE`
`18`	Invalid price increment	`INVALID_PRICE_TICK`
`25`	Insufficient credit limit	`INSUFFICIENT_BALANCE`
`41`	Exceeded position limit	`POSITION_LIMIT_PER_INSTRUMENT_EXCEEDED`
`42`	Invalid client	`INVALID_USER`
`43`	Client permission error	`USER_TRADING_LOCKED`
`44`	Not allowed by market state	`INSTRUMENT_NOT_ACTIVE`
`48`	Reduce only	`REDUCE_ONLY_VIOLATION`
`99`	Other	`SELF_MATCH_PREVENTION`, `SPEED_BUMP_QUEUE_FULL`, `INVALID_FIELD_VALUE`, and any label not listed above

OrderCancelReject (35=9)

Sent when an OrderCancelRequest (35=F) cannot be applied. Cancel rejects for requests made through other channels are not sent on FIX.

Tag	Name	FIX Type	Req	Description
11	ClOrdID	String	Y	`ClOrdID` of the cancel request.
41	OrigClOrdID	String	N	`OrigClOrdID` of the cancel request. Omitted when the request identified the order by `OrderID` only.
37	OrderID	String	N	Exchange order ID. `0` when the order is unknown.
39	OrdStatus	Char	Y	`U` = Undefined. The reject carries no order state.
102	CxlRejReason	Int	N	`1` = Unknown order. `0` = Too late to cancel (order already filled). `3` = Cancel already pending for this order.
434	CxlRejResponseTo	Char	Y	`1` = Order cancel request.
58	Text	String	N	Always sent: `UNKNOWN_ORDER`, `ORDER_ALREADY_FILLED`, or `CANCEL_ALREADY_PENDING`.

102=1 (Text UNKNOWN_ORDER) covers an order that never existed, an order that is already canceled or expired, and an order that belongs to another user. To tell them apart, check the ExecutionReports you received for that ClOrdID. A fully filled order gets 102=0 with Text ORDER_ALREADY_FILLED.

OrderMassCancelReport (35=r)

Summarizes an OrderMassCancelRequest (35=q). It is sent after the individual Canceled reports.

Tag	Name	FIX Type	Req	Description
11	ClOrdID	String	Y	`ClOrdID` of the mass cancel request.
1369	MassActionReportID	String	Y	Exchange report ID, in the same number space as `ExecID`. `0` when the request was rejected on receipt.
530	MassCancelRequestType	Char	Y	Echoes the type you sent.
531	MassCancelResponse	Char	Y	`7` = Accepted. `0` = Rejected. No other value is sent.
532	MassCancelRejectReason	Int	N	Sent when `531=0`. `0` = Mass cancel type not supported. `1` = Invalid or unknown instrument (missing or unknown `55` with `530=1`). `99` = Other.
533	TotalAffectedOrders	Int	N	Number of orders canceled. `0` on a reject.
60	TransactTime	UTCTimestamp	Y	Event time, microsecond precision.
58	Text	String	N	Reject reason. Rejects only.

531=7 does not report the scope that ran. Use TotalAffectedOrders (533) to see how many orders were canceled.

MarketSettlementReport (35=UMS)

Sent when an instrument settles, once per firm and instrument. You receive it only if you sent ReceiveSettlementReports (20127) = Y on Logon (35=A). Every connected session of the firm that opted in receives the same report.

Tag	Name	FIX Type	Req	Description
20105	MarketSettlementReportID	String	Y	Report ID, in the same number space as `ExecID`.
55	Symbol	String	Y	Settled instrument ticker.
453	NoPartyIDs	NumInGroup	Y	`2`
→ 448	PartyID	String	Y	FCM code, then firm code.
→ 452	PartyRole	Int	Y	`4` = Clearing firm, then `1` = Executing firm.
21052	SettlementOutcome	Char	Y	`Y` = YES wins (price `1.000`). `N` = NO wins (price `0.000`). `S` = Scalar (price between).
730	SettlementPrice	Price	Y	Settlement price, 3 decimal places.
21053	PositionAggregationMode	Char	Y	Firm’s position mode. `N` = Net. `G` = Gross.
21054	LongQty	Qty	Y	Long contracts held just before settlement.
21055	ShortQty	Qty	Y	Short contracts held just before settlement.
21056	PayoutAmount	Amt	Y	Gross payout in USDC: `SettlementPrice × LongQty + (1.000 − SettlementPrice) × ShortQty`. Not profit or loss. Never negative.
60	TransactTime	UTCTimestamp	Y	Settlement time, microsecond precision.

With 21053=N, at most one of LongQty and ShortQty is non-zero. With 21053=G, both can be non-zero.
Settlement is reported per firm, not per sub-account.

BusinessMessageReject (35=j)

Sent when an application message is rejected before it reaches the exchange. No ExecutionReport follows.

Tag	Name	FIX Type	Req	Description
45	RefSeqNum	SeqNum	N	`MsgSeqNum (34)` of the rejected message.
372	RefMsgType	String	Y	`MsgType (35)` of the rejected message.
379	BusinessRejectRefID	String	N	`ClOrdID (11)` of the rejected message, or the invalid value when an identifier field fails validation.
380	BusinessRejectReason	Int	Y	`0` = Other. Sent for every BusinessMessageReject.
58	Text	String	N	Reason. See the table below.

Condition	Text (58)
Missing required tag, invalid value, or other dictionary validation failure	`sessionRejectReason=` followed by the FIX session reject reason code, and `tag=` with the tag number when known
`ClOrdID`, `OrigClOrdID`, or sub-account in an invalid format	`invalid ClientOrderId` or `invalid PartyID`, or a message stating the accepted lengths
Unknown ticker on NewOrderSingle	`unknown Symbol`
Order type, price, post-only, sub-account, or trading lock rules	See Order type and price rules
Executing firm rules	See Executing firm
MaxExecutionCost rules	See Max execution cost
Your API key no longer has `TRADE` permission, or its scope no longer resolves (NewOrderSingle and EventResendRequest)	`authenticated principal lacks TRADE permission` or `authenticated principal scope is unavailable`
OrderCancelRequest without `37` or `41`	`OrderID(37) or OrigClOrdID(41) required`
Session message rate exceeded (cancels and mass cancels are exempt)	`session rate throttle`
Unsupported `MsgType (35)`	`unsupported message type`

Values specific to Coinbase Derivatives: Predictions

The gateway uses standard FIX 5.0 SP2 tags where they exist. The following messages and tags are specific to Coinbase Derivatives: Predictions.

Tag or message	Name	Description
`35=UMS`	MarketSettlementReport	See MarketSettlementReport (35=UMS).
`35=F1` to `35=F5`	Event resend messages	See LastExecIDRequest (35=F1) through EventResendReject (35=F5).
8013	CancelOrdersOnDisconnect	Logon. See Cancel on disconnect.
20127	ReceiveSettlementReports	Logon. Opts in to MarketSettlementReport.
21009	MaxExecutionCost	NewOrderSingle. See Max execution cost.
7928, 8000	SelfMatchPreventionId, SelfMatchPreventionStrategy	See Self-match prevention.
20105, 21052 to 21056	Settlement fields	See MarketSettlementReport (35=UMS).
22003 to 22006	Event resend fields	See EventResendRequest (35=F3).

REST API Overview

REST Endpoints

FIX

WebSocket

Coinbase Derivatives: Predictions FIX Order Entry Messages

Order Entry Message Types

Connection

Prices, quantities, and sides

Identifiers

NewOrderSingle (35=D)

Order type and price rules

Executing firm

Max execution cost

Self-match prevention

OrderCancelRequest (35=F)

OrderMassCancelRequest (35=q)

ExecutionReport (35=8)

Pending New (35=8, 150=A)

New (35=8, 150=0)

Trade (35=8, 150=F)

Canceled (35=8, 150=4)

Expired (35=8, 150=C)

Rejected (35=8, 150=8)

OrdRejReason values

OrderCancelReject (35=9)

OrderMassCancelReport (35=r)

MarketSettlementReport (35=UMS)

BusinessMessageReject (35=j)

Values specific to Coinbase Derivatives: Predictions

​Order Entry Message Types

​Connection

​Prices, quantities, and sides

​Identifiers

​NewOrderSingle (35=D)

​Order type and price rules

​Executing firm

​Max execution cost

​Self-match prevention

​OrderCancelRequest (35=F)

​OrderMassCancelRequest (35=q)

​ExecutionReport (35=8)

​Pending New (35=8, 150=A)

​New (35=8, 150=0)

​Trade (35=8, 150=F)

​Canceled (35=8, 150=4)

​Expired (35=8, 150=C)

​Rejected (35=8, 150=8)

​OrdRejReason values

​OrderCancelReject (35=9)

​OrderMassCancelReport (35=r)

​MarketSettlementReport (35=UMS)

​BusinessMessageReject (35=j)

​Values specific to Coinbase Derivatives: Predictions

Order Entry Message Types

Connection

Prices, quantities, and sides

Identifiers

NewOrderSingle (35=D)

Order type and price rules

Executing firm

Max execution cost

Self-match prevention

OrderCancelRequest (35=F)

OrderMassCancelRequest (35=q)

ExecutionReport (35=8)

Pending New (35=8, 150=A)

New (35=8, 150=0)

Trade (35=8, 150=F)

Canceled (35=8, 150=4)

Expired (35=8, 150=C)

Rejected (35=8, 150=8)

OrdRejReason values

OrderCancelReject (35=9)

OrderMassCancelReport (35=r)

MarketSettlementReport (35=UMS)

BusinessMessageReject (35=j)

Values specific to Coinbase Derivatives: Predictions