TÝR Markets API
Quotes
In order to subscribe to quotes feed a connection to following WebSocket endpoint must be established:
/volven-broker/quotes
After establishing connection you can subscribe to one of three types of quotes:
BASIC
: just a single price (mid-spread), used for presentation purposes only (it is not a price offered for trading)TRADING
: Two quotes (buy and sell) will be offered with very short validity (few seconds). These are the quotes that once accepted by the user can be traded on.FULL
: Full order book, can be used to check available liquidity distribution.
In order to subscribe one of following messages should be sent over the WebSocket:
For basic quotes:
{
"quoteType": "BASIC",
"productCode": "btcnok"
}
For trading quotes:
{
"quoteType": "TRADING",
"productCode": "btcnok",
"inputSize": null,
"inputValue": "1000"
}
inputSize
is a trade size (in base currency).
inputValue
is a trade value (in quote currency).
Note that exactly one of inputSize
and inputValue
must be provided.
In above example clients wants to get quotes for buying or selling 1000 NOK worth of Bitcoin.
For full quotes:
{
"quoteType": "FULL",
"productCode": "btcnok"
}
Available product codes for TÝR Markets can be obtained by calling product metadata endpoint with VB
exchange code parameter:
GET /mms/v2/productDetails?exchangeCode=VB
After successful subscription you will receive subscription acknowledgement message (contents of this message are out-of-scope of this documentation, they mainly serve a technical purpose and are subject to change at any time):
{
"msgType": "ACK",
"userId": 42,
"query": {
"quoteType": "TRADING",
"productCode": "btcnok",
"inputSize": null,
"inputValue": 1000
},
"config": {
...
}
}
ACK message might be also occasionally sent when global configuration has been changed. These messages might be simply ignored.
Immediately after ACK message you will be getting quotes for subscribed product(s) twice per second until disconnected (there is no unsubscribe option).
Quote messages will have corresponding msgType
field:
BQ
for basic quoteTQ
for trading quoteFQ
for full quote
Example trading quote would look like this:
{
"msgType": "TQ",
"id": "98033829-efc4-441e-879c-2d7e5feabb72",
"productCode": "btcnok",
"baseCcy": "BTC",
"quoteCcy": "NOK",
"buyQuote": {
"price": 1119318,
"size": 0.000089,
"value": 99.62,
"feeInBaseCcy": 0.0000003115,
"feeInQuoteCcy": 0.35
},
"sellQuote": {
"price": 1119318,
"size": 0.000089,
"value": 99.62,
"feeInBaseCcy": 0.0000003115,
"feeInQuoteCcy": 0.35
},
"spread": 0,
"spreadPercentage": 0,
"dailyChangePercentage": -0.0212,
"validUntil": "2025-09-22T17:00:47.491044354Z"
}
Trading
Trading API is not exposed to external clients yet. It will be available and documented soon.
Last updated
Was this helpful?