Summon Requesters

This page walks a requester through Summon from first message to certification. For the request types and timings, see Getting Started with Summon.

1. Summon or Summon with a Limit

QuoteType (537) is required, and it decides how your request is handled:

  • Summon, 537=0: responders' quotes show on the order book, and you trade by hitting them on TR.
  • Summon with a limit, 537=1 and a price (44): OpenYield places a limit order at your price on the book 5 seconds after your request.

A request with 537=1 and no price places nothing at 5 seconds. Use 537=0 for a Summon.

Updates and cancels depend on the type:

  • Summon (537=0): an update is acknowledged as Replaced and a cancel as Canceled, on the OrderID in Pending New, and both are re-sent to responders.
  • Summon with a limit (537=1): they change only your limit and are not sent to responders. See sections 9 and 10.

2. Sessions

You need RQ to send requests and receive acknowledgements, and TR, because fills arrive on TR (and DC), never on RQ. To see every response, use OB; MD shows top of book only. You do not need a market-data session if you only use a Summon with a limit or Legacy RFQ.

3. Send a Request

Send a QuoteRequest (35=R) on RQ with:

Tag Field Value
131 QuoteReqID Your ID for the request. Reuse it to update or cancel.
146 NoRelatedSym 1. Use one security per request.
55, 48, 22 Symbol, SecurityID, SecurityIDSource The security, in both 48 and 55; ISIN by default (22=4)
54 Side What you want to do: 2 (Sell) for bids back, 1 (Buy) for offers back
38 OrderQty Required, in your connection's quantity unit (bonds by default). Send 100 when you have no size in mind.
537 QuoteType Required: 0 for a Summon, 1 for a Summon with a limit
44 Price Your limit, with 537=1: it goes on the book at 5 seconds. With 537=0 it places nothing; it is used only in the order-value check.
453, 448, 452 Parties Your Client ID in PartyRole 3. See Party Blocks.

If 537, 54, 22 or 38 is missing, OpenYield replies with a BusinessMessageReject (35=j). A request without 38 is rejected as Conditionally Required Field Missing (38) (372=R, 380=5). For example, a Summon with a limit to sell 100 bonds at 101.255:

8=FIX.4.4 9=178 35=R 34=9 49=BASTION-RQ 52=20250213-18:48:22.941 56=OPENYIELD-RQ 131=REQ-COR-0002 146=1 55=US023135CF19 48=US023135CF19 22=4 537=1 54=2 38=100 44=101.255 453=1 448=Bastion 452=3 10=252

See Initiate a New Summon for the full field table and the acknowledgements.

4. Acknowledgement

OpenYield acknowledges every accepted request with an ExecutionReport on RQ: ExecType New (150=0), OrdStatus Pending New (39=A), an OrderID (37), and your price in Price (44), or 0 if you sent none. This is a receipt acknowledgement that the staging service is working the RFQ; it does not create a live order.

5. Responses

Responses are quotes on the live order book. Use OB to see every response. MD shows only the best bid and offer, so a response behind the best price does not create an MD update. Hit or lift a response with an order on TR, as for any other order.

6. Plain Summon: End to End

A plain Summon has 537=0 and no price (44). The following abbreviated messages show the complete flow for a requester buying 100 bonds. They come from a test environment, where ExpireTime (126) is 10 seconds after the request instead of 30:

35=R 131=122106-PF001 537=0 54=1 38=100

OpenYield returns Pending New on RQ to confirm that it accepted the RFQ. Quotes may arrive during the response window; there is no later terminal report for a plain Summon:

35=8 11=122106-PF001 37=ORD20261111-SLX-000000000058 54=1 38=100 44=0 151=100 39=A 150=0

A responder receives the inverse-side request and posts a quote. The quote arrives on OB as an IOI:

35=R 131=RFO20261111-SLX-000000000038 537=0 54=2 38=100 62=20261111-17:21:11 126=20261111-17:21:16
35=S 131=RFO20261111-SLX-000000000038 117=FLAME-RR-00000021 537=0 54=2 133=94.634536059 135=100
35=6 23=IOI20261111-000000000219 54=2 44=94.634536059 27=100 28=N

The requester hits it on TR and receives the fill on TR:

35=D 11=FRQ20261111-000000000006 54=1 38=100 44=94.634536059 60=20261111-17:21:07
35=8 11=FRQ20261111-000000000006 37=ORD20261111-MLX-000000000223 17=FIL20261111-000000000006 54=1 38=100 44=94.634536059 6=94.634536059 14=100 32=100 31=94.634536059 151=0 39=2 150=F

7. Summon with a Limit

On a Summon with a limit, your limit goes on the book 5 seconds after the request. You receive New (39=0) on RQ with a new OrderID (37). Fills arrive on TR and DC. See Summon with a Limit is Executed.

8. EMS and OMS Patterns

An EMS or OMS can expose a Summon action beside each bond, or apply it to each line of a basket. It can also send a Summon automatically before routing when displayed size is short of the order. Show the end of the 30-second response window beside the request, and offer to re-Summon when it ends. A plain Summon has no terminal RQ report because it is an RFQ, not a live order; use the original request time to drive the response-window countdown.

9. Update

Resend the request with the same QuoteReqID (131) to update it. You can change quantity (38) and price (44) only.

  • Summon: OpenYield acknowledges with Replaced (150=5, 39=5) on the OrderID in Pending New, and re-sends the request to responders with the new OrderQty (38) and the original ValidUntilTime (62) and ExpireTime (126). Their quotes already on the book are not changed.
  • Summon with a limit, within 5 seconds: no acknowledgement or Replaced report. The new values are used for the limit at 5 seconds, and the resulting New report is the first confirmation of that live limit.
  • Summon with a limit, after 5 seconds: your live limit is replaced, and you receive Replaced on the OrderID in the New report. Responders receive no RQ notification, although the revised limit is visible on OB.

See Update a Summon.

10. Cancel

Resend the request with the same QuoteReqID (131) and OrderQty 38=0 to cancel.

  • Summon: OpenYield acknowledges with Canceled (150=4, 39=4) on the OrderID in Pending New, and re-sends the request to responders with 38=0. Their quotes already on the book are not pulled; they stay until the responders cancel them or auto-pull removes them.
  • Summon with a limit, within 5 seconds: Canceled on the OrderID in Pending New, and nothing is placed.
  • Summon with a limit, after 5 seconds: one Canceled on the OrderID in the New report. Responders receive no RQ notification, although the cancellation is visible on OB.

On a Summon with a limit, a cancel for an unknown QuoteReqID, or one sent after the limit has been auto-pulled, gets no reply. On a Summon, a cancel for an unknown QuoteReqID is checked like a new request and can be rejected, for example as a duplicate (103=6). See Cancel a Summon.

11. At 30 Seconds

When your connection is configured for auto-pull—the default on new connections—OpenYield cancels what remains of your limit 30 seconds after the request. You receive Canceled (150=4, 39=4) with ClOrdID (11) set to your QuoteReqID plus -CANCEL, and OrigClOrdID (41) set to your QuoteReqID. A plain Summon is an RFQ, not a live order, and receives no terminal RQ report when its response window ends. Confirm the setting for an older or exceptional connection with OpenYield. See Automated Request Cancel.

12. Rejects

Rejects are ExecutionReports on RQ: ExecType Rejected (150=8), OrdStatus Rejected (39=8), an OrdRejReason (103) and, except for security rejects, a Text (58):

OrdRejReason (103) Meaning
1 Unknown security
2 Market closed or not open
3 Exceeds exposure limit
5 Unknown order, or an update that changes more than quantity and price
6 Duplicate: you already sent requests for the same security, side, size and price within the duplicate window. The reject's OrderID (37) is ORD<date>-000000000000
8 Price check failed
9 Party inactive
10 Counterparty or contract not set up
11 Order not supported
13 Quantity check failed
99 Other

13. Legacy RFQ

If your system doesn't read the order book, OpenYield can set up your connection to forward the responses to your requests with 537=1 to you as quotes on RQ, 5 seconds after your request. You accept one with a QuoteResponse (35=AJ). The accept becomes a new limit order on the book for the size and price you send. See Legacy RFQ.

14. Certification

Run the certification scenarios for the request type you send: Summon Requester for 537=0, and Summon with a Limit Requester for 537=1. Run Legacy RFQ scenarios only when that connection feature is enabled. See Certification Checklist.