Async Websocket API for deriv-app

Code Coverage:

Node.js (v12.18.0 or higher is recommended)

npm install @deriv/deriv-api

yarn add @deriv/deriv-api

The basic library is a lighter version of the Deriv API, suitable for apps that want to directly deal with API calls.

It can either be imported as a separate module (to reduce the final bundle size) or if the DerivAPI library is already imported, can be accessed using api.basic.

const api = new DerivAPI({...args});
const basic = api.basic;

basic.ping().then(console.log);

// Smaller bundle size, dealing only with the low-level library
import DerivAPIBasic from '@deriv/deriv-api/dist/DerivAPIBasic';

const api = new DerivAPIBasic({app_id: /* your app_id */ });

// Smaller bundle size, dealing only with the low-level library
const DerivAPIBasic = require('@deriv/deriv-api/dist/DerivAPIBasic');

const api = new DerivAPIBasic({app_id: /* your app_id */ });

<script src="https://unpkg.com/@deriv/deriv-api/dist/DerivAPIBasic.js"></script>
<script>
const api = new DerivAPIBasic({app_id: /* your app_id */ });
/* rest of your code */
</script>

There are two ways to establish a connection:

1. Use a previously opened connection:

   const connection = new WebSocket('ws://...');
   const api        = new DerivAPI({ connection });

2. Pass the arguments needed to create a connection:

   const api = new DerivAPI({ endpoint: 'ws://...', app_id: /* your app_id */, lang: 'EN' });

There is a short tutorial about how to use Deriv API in the wiki page.

The complete API reference is hosted here

The above reference in one page: DerivAPI reference

git clone https://github.com/binary-com/deriv-api
cd deriv-api
npm install

npm test

npm run devel

npm run syntax

npm run test_all

npm run prettify

npm run docs

Needs inotify to work.

npm run devel_docs

npm run serve_docs

npm run gh-pages

npm run build

DERIV_TOKEN=YourTokenHere npm run examples