binary-live-api

This repository is deprecated, please use https://github.com/binary-com/deriv-api/ instead.

This library is a high-level abstraction over the Binary.com Websockets API

Features

1. Promise based, all network calls return a promise that is resolved when response is received, request response mapping is handled out of the box
2. Automatic reconnect when disconnection, including resubscribe to subscription made before disconnection

Usage in the Browser

var api = new LiveApi();
api.authorize('yourtoken');
api.getPortfolio();
api.events.on('portfolio', function(data) {
    // do stuff with portfolio data
});

Usage From Node

Install a WebSockets library like 'ws'

npm init
npm install ws --save
npm install binary-live-api --save

Alternatively, you can add the library to your project with the following link: https://liveapi.binary.com/binary-live-api.js - or to fix to a specific version, put the version number in the URL as follows: https://liveapi.binary.com/27.0.0/binary-live-api.js

Require the library and then pass it to LiveApi's constructor.

var ws = require('ws');
var LiveApi = require('binary-live-api').LiveApi;

var api = new LiveApi({ websocket: ws });
api.authorize('yourtoken');
api.getPortfolio();
api.events.on('portfolio', function(data) {
    // do stuff with portfolio data
});

For all available calls, please check here

Experimental feature (Not for production)

support RxJs

User can opt to use observables API instead of Promise API by passing useRx = true in constructor, like below

var api = new LiveApi({ useRx: true });
api.ping()      // return Observable, instead of Promise

No more global events ~!! as Stream is now modelled as observables, you can pass it around, instead of listening to global event. This will allow better composition of streams, right now it only include rx.lite, thus not all observables operator are supported, all supported operators can be check here

Example

var api = new LiveApi({ useRx: true });
var r100TickStream = api.subscribeToTicks('R_100');

// silly example, but to illustrate you can now operate on them independently
var epochs = r100TickStream.map(function(json){return json.tick.epoch});
var quotes = r100TickStream.map(function(json){return json.tick.quote});

To deploy as library on gh pages

run gulp deploy to deploy library to origin/gh-pages

run gulp deploy-prod to deploy library to upstream/gh-pages