Overview
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 to.
Server
Setup
Currently the quote server is hosted on kodiak-dev → C:\temp\publish\Kodi.Kodiak.Quotes.Api . To start the server, simply run the application as administrator.
The swagger for the server can then be viewed on kodiak-dev here: http://localhost:7080/swagger/index.html
Or on your local machine here:
https://kodiak-dev.kodi.is:7081/swagger/index.html
The server contains the following operations:
GET
"/api/quotes/login/{token}"
Returns an object containing all quotes, quote offers and quote trades for today.
POST
"/api/quotes"
Body: CreateQuoteRequest
To send a new quote request
DELETE
"/api/quotes/{quoteId}"
Body: CancelQuoteRequest
To cancel the quote specified by the quoteId
POST
"/api/quotes/{quoteId}/offer_quote"
Body: CreateQuoteOfferRequest
To send a quote offer to the quote specified by the quoteId
POST
"/api/quotes/{quoteId}/accept_quote"
Body: AcceptQuoteOfferRequest
To accept a quote offer for the quote. Quote offer specified in accept quote type
Client
You can open a new quote window under Trading → Quotes
Flow
The initiator starts the process by creating a quote. The required fields are buy/sell, quantity, Symbol, Price and a list of counterparties.
All counterparties specified in the counterparties list will receive the quote and have around 3 minutes to respond before the quote expires.
The recipient can respond to the quote 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.
Finally, the initiator can accept one or more of the quote offers.
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 be equal to or lower than the price 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:
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…
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 and generated quote trades.
By default, quotes are shown in the trade ticker, but the setting can be enabled/disabled for each trade ticker window under Trade Ticker Settings.
It is also possible to enable/disable showing quotes in the trade ticker by default when opening a new trade ticker window under Tools → Settings → Market Data → Show quotes by default. The current workspace needs to be saved and the client restarted for the setting to be modified.
