liquid-qex v0.6.1

LiquidQex Javascript Client

A javascript client for interacting with the Quick Exchange server through Tap.

This is dependent on the LiquidTap client library.

Quick Start

npm install --save liquid-tap
npm install --save liquid-qex

import { TapClient } from "liquid-tap";
import { QexClient, ProductType, SIDE } from "liquid-qex";

const tap = new TapClient();
const qex = new QexClient(tap);

const channel = qex.quoteStream(
  "BTC/JPY",
  "JPY",
  SIDE.BUY,
  500
);

channel.bind("updated", data => console.log(JSON.stringify(data, null, 2)));

Authentication

For informaiton on how to authenticate, see LiquidTap

In the example below, the QEX server will tick back indicative quotes only (not tradable).

import LiquidTap from 'liquid-tap';
import { QexClient }, { SIDE } from 'liquid-qex';


const tap = new LiquidTap();
const qex = new LiquidQex(tap)

const channel = qex.quoteStream('BTC/JPY', 'JPY', SIDE.BUY, 500);

channel.bind('updated', quote => {
  console.log(quote.client_ask.state);
  // INDICATIVE
});

Once a user in authenticated, the quotes (can) be dealable

import LiquidTap from 'liquid-tap';
import { QexClient }, { SIDE } from 'liquid-qex';


const tap = new LiquidTap();
const qex = new LiquidQex(tap)

tap.authenticate(signedJwt);

const channel = qex.quoteStream('BTC/JPY', 'JPY', SIDE.BUY, 500);

channel.bind('updated', quote => {
  console.log(quote.client_ask.state);
  
  qex.tradeOnQuote(quote, side, vendorId, allowPriceImprovement, account, openingUserId)
});

Buy Sell Helper Class

A helper class exists to simplify the construction and side selection of the quote stream request.

Initialization

let request = new BuySellHelperImmutable({ sellCcy: 'USD', buyCcy: 'BTC', fixSide: SIDE.SELL });

Input Methods

Output Methods

Quote Parser

const quoteParser = new QuoteParser(request, quote);

Output Methods

Useage

import { QexClient, BuySellHelperImmutable } from '../src/index';
const defaultQuantity = 50;
const helper = new BuySellHelperImmutable({sellCcy: 'USD', buyCcy: 'BTC', fixSide: SIDE.SELL, quantity: defaultQuantity});
...
const channel = qex.quoteStream(helper.symbol(), helper.currency(), helper.side(), 500);
channel.bind('updated', (quote) => {
  console.log("Rate: " + quote[helper.rateField()].value);
});

There also can be used with ReactJS.

import { QexClient, RequestHelperImmutable } from '../src/index';
const tapClient = new TapClient();
const qexClient = new QexClient(tapClient);
class MyComponent extends React.Component {
  constructor() {
    this.state = {
      request: new RequestHelperImmutable('USD', 'BTC');
      quoteRaw: new QuoteParser();
    }
  }

  openStreamingQuote(request) {    
    this.setState({ request })
    const channel = qexClient.quoteStreamFromHelper(helper);
    channel.bind('updated', (quoteStr) => {
      this.setState({quoteRaw: JSON.parse(quoteStr)})
    });    
  }

  handleUserInputOnTextBox1 = (event) => {
    // user changes quantity in funding side textbox
    openStreamingQuote(request.fixCcy1(event.target.value));
  }

  handleUserInputOnTextBox2 = (event) => {
    // user changes quantity in payout side textbox
    openStreamingQuote(helper.fixCcy2(event.target.value));
  }

  handleChangeCurrency1 = (event) => {
    // user changes funding currency
    openStreamingQuote(helper.setCcy1(event.target.value));
  }

  handleChangeCurrency2 = (event) => {
    // user changes payout currency
    openStreamingQuote(helper.setCcy2(event.target.value));
  }

  render(){
    const {request, quoteRaw} = this.state;
    const quoteParser = new QuoteParser(request, quoteRaw);
    return (
      <div>
        <input type="number" value={quoteParser.sellQty()} onChange={this.handleUserInputOnTextBox1}/>
        <input type="number" value={quoteParser.buyQty()} onChange={this.handleUserInputOnTextBox1}/>
      </div>
    )
  }
 
}

References

Function Requirements https://quoine.atlassian.net/wiki/spaces/PRODM/pages/865739240/Quick+Exchange+Functional+Requirements