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:

  1. For basic quotes:

{
    "quoteType": "BASIC",
    "productCode": "btcnok"
}
  1. 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.

  1. 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

Passing null as product code will subscribe to all available products.

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": {
        ...
    }
}

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 quote

  • TQ for trading quote

  • FQ 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"
}

It is not possible to have multiple subscriptions at the same time.

If you send another subscription request this will replace existing subscription with a new one (you will receive another ACK message).

Trading

Trading API is not exposed to external clients yet. It will be available and documented soon.

Last updated

Was this helpful?