...
Request for quote is a control used for buying and selling bonds. The Kodiak implementation implements Directed Request for Quote where counterparties need to be selected to send the quote request to.
TODO: Update page with information for how to use the new token service
Server
The server validates tokens from Kodiak Token Issuer and it is necessary to include tokens from there as bearer tokens to communicate with the RFQ server.
...
| Code Block |
|---|
GET "/api/quotes/login/{token}" Returns an object containingSends all quotes, quote offersdata andto quotequotes tradesqueue for today.the user POST "/api/quotes" Body: CreateQuoteRequestCreateQuoteRequestRequest To send a new quote request Example body: { "Symbol": "HFF150434", "Side": 1, "Price": 100.0, "MinimumQuantity": 20000.0, "MaximumQuantity": 40000.0, "ExposureDuration": 300, "ClientReference": "Test quote request", "Counterparties": ["ISY48"] } DELETE "/api/quotes/{quoteId}" Body: CancelQuoteRequestCancelQuoteRequestRequest To cancel the quote request specified by the quoteId quoteRequestId Example body: { "QuoteRequestId": 100 } POST "/api/quotes/{quoteIdquoteRequestId}/offer_quote" Body: CreateQuoteOfferRequestCreateQuoteRequest To send a quote to the quote request specified by the quoteRequestId Example body: { "QuoteRequestId": 100, "Side": 1, "Price": 100.0, "Quantity": 20000.0, "ClientReference": "Test quote" } DELETE "api/quotes/{quoteRequestId}/offer_quote" Body: CancelQuoteRequest To cancel the quote sent to the quote request specified by the quoteIdquoteRequestId Example body: { "QuoteRequestId": 100, "QuoteId": 50 } POST "/api/quotes/{quoteId}/accept_quote" Body: AcceptQuoteOfferRequestAcceptQuoteRequest To accept a quote offer for the quote. Quote offer specified in accept quote type Example body: { "QuoteRequestId": 100, "QuoteId": 50, "Side": 1, "Price": 100.0, "Quantity": 20000.0 } |
Client
You can open a new quote window under Trading → QuotesRequest For Quote
Flow
The initiator starts the process by creating a quote request. The required fields are Buy/Sell/Both, quantity, Symbol , Price and a list of Counterparties.
...
The default lifetime of a quote request is 180 seconds, but any other duration can be specified. Min Quantity will be visible to the respondent of the quote request, but price, Max Quantity and Client Reference can only be seen by the initiator.
...
All counterparties specified in the counterparties list will receive the quote and have around 3 minutes to respond before the quote expires.
...
request. The amount of time they have to respond to the quote request is the lifetime specified in the quote request.
...
The recipient can respond to the quote request with a quote offer. The required fields are buy/sell, quantity and price. None of the fields are limited by any of the fields specified in the initial quote.
...
Client Reference will can only be seen by the respondent.
...
Finally, the initiator can accept one or more of the quote offersquotes.
...
The buy/sell side is limited to the buy/sell side of the quote offer. The required fields are quantity and price. The price needs to be equal to or higher than the price of the quote offer if the accepting quote offer has a sell side. The price needs to quantity must be equal to or lower than the price quantity of the quote offer if the accepting quote offer has a buy side. The quantity must be equal to or lower than the quote offer in all cases.
...
...
When a quote offer is accepted, a manual trade is generated.
Using Postman collection to call EMS
It isn’t possible to respond to a quote internally, and we’re unsure about whether or not we will implement it in the future. Therefore, to go through the entire flow from creating a quote to generating a quote trade, you can use the postman collection included here to call ems-s and ems-s2 for testing purposes:
| View file | ||
|---|---|---|
|
This collection contains methods to call ems-s and ems-s2 to make quote requests, including sending a quote, canceling a quote, sending a quote offer and accepting a quote offer.
You’ll first have to fill the environment variables for y48/y49_username and y48/y49_password with a y48/y49 user and password combination. You can edit these variables in the right hand sidebar under “Environment quick look”.
In order to be able to send requests to ems-s or ems-s2, you’ll first have to authenticate through “Get token - y48/y49”. The token response will then be saved in the environment and you can send requests to ems-s and/or ems-s2.
Examples
Example flow using the OMS Client as an initiator and a y_49 user as the respondent using postman:
You create a quote using the OMS Client, adding ISY49 as a counterparty
You find the EXCHANGE_QUOTE_MESSAGE_ID of the quote in the kodiak-dev database using this select statement:
SELECT TOP(10) * FROM QUOTES ORDER BY ID_QUOTES DESC
You insert the EXCHANGE_QUOTE_MESSAGE_ID into the url for “Quote offer - y49”:
You can change the trader_id, side, price or quantity in the body
You accept the quote offer in the client. The quote will get a status of filled and a new trade will be generated
Example flow using the y_49 trader as the initiator through postman and the OMS Client as the respondent:
You create a new quote in postman under “Enter quote - y49”
You send a quote offer in the OMS Client
The id to accept the quote offer through ems-s2 isn’t available to us anywhere so the flow can’t be completed as of right now…
, at which point the counterparty for the quote will be visible to both sides.
...
Trade ticker
Optionally, quotes can be displayed in the trade ticker for Genium/Inet bonds. Quotes are marked orange in the trade ticker. The trade ticker can only display quote offers quotes and generated quote trades, but not the quote requests.
...
By default, quotes are not shown in the trade ticker, but the setting can be enabled/disabled for each trade ticker window under Trade Ticker Settings.
...