aggregator-cexio

CEX.IO Aggregator

The official Node.js client for aggregator.cex.io API (https://docs-aggregator.cex.io)

Features

• Easy to use, requires only key-secret pair to setup
• Handle all transport work, just call required action
• Popular protocols supported, REST and WebSocket onboard

Installation

npm install aggregator-cexio

Rest client

const { RestClient } = require('aggregator-cexio')
const defaultClient = new RestClient()
const authenticatedClient = new RestClient(apiKey, apiSecret, options)

Arguments for RestClient are optional. For private actions you need to obtain apiKey + apiSecret pair from your manager.

• apiKey string - Api key for specific account.
• apiSecret string - Api secret for specific account.
• options object - Additional settings for client.

Available client options described below, they all are optional:

• apiLimit integer - Rate limit value for apiKey, default is 300. Client will check requests count and prevent from spam the server. You can ask to increase this limit.
• timeout integer - Request timeout in milliseconds, default is 30000.
• rejectUnauthorized boolean - This option useful when you test demo env, default: true.
• apiUrl string - Can be changed to test your bot on demo environment. default is 'https://rest-aggregator.cex.io/'

Public actions

To make a public request use async callPublic(action, params) method. This method return Promise which resolves with server response. If some error was occured then method rejects with status code and error description.

For more details check api refference.

const { RestClient } = require('aggregator-cexio')

const client = new RestClient()

client.callPublic('get_demo_order_book')
  .then(res => console.log(res))
  .catch(err => console.error(err))

{ error: 'Bad Request', statusCode: 400 }
{ error: 'Unexpected error', statusCode: 500 }

Private actions

To make private api calls use async callPrivate(action, params). It's similar to public method but requires apiKey and apiSecret arguments to client initialization. Each private request is signed with HMAC sha256 so if key is incorrect or signature is wrong client will return rejected promise with error like this { error: 'Authorization Failed', statusCode: 401 }

const { RestClient } = require('aggregator-cexio')

const key = '_account_api_key_'
const secret = '_account_api_secret_'
const action = 'get_my_trading_conditions'
const params = {
  pairs: ['BTC-USD']
}

const client = new RestClient(key, secret)

client.callPrivate(action, params)
  .then(res => console.log(res))
  .catch(err => console.error(err))

Success response example:

{ ok: 'ok', data: { ... } }

WebSocket client

const { WebsocketClient } = require('aggregator-cexio')
const ws = new WebsocketClient(apiKey, apiSecret, options)

To init the WebsocketClient you must pass apiKey and apiSecret arguments. You can obtain them from your manager.

• apiKey string - Api key for specific account.
• apiSecret string - Api secret for specific account.
• options object - Additional settings for client.

Available client options described below, they all are optional:

• wsReplyTimeout integer - Request timeout in milliseconds, default is 30000.
• rejectUnauthorized boolean - This option useful when you test demo env, default: true.
• apiUrl string - Can be changed to test your bot on demo environment. default is 'https://ws-aggregator.cex.io/'

Call Private actions

To send request to the server you need to connect and auth first. Everything is under the hood and all you need is call async ws.connect() method. After that you can invoke async ws.callPrivate(action, params) method which returns Promise with server response. If some error was occured then method rejects with status code and error description.

  const { WebsocketClient } = require('aggregator-cexio')
  const ws = new WebsocketClient(apiKey, apiSecret, options)

  await ws.connect() // connect and auth on the server

  const res = await ws.callPrivate(action, params)
  console.log('result:', res)

  ws.disconnect() // close connection

Subscribe to updates

The WebsocketClient allows you to receive updates. At the now available two types of updates account_update and executionReport. You can get more details about them in documentation.

const { WebsocketClient } = require('aggregator-cexio')
const ws = new WebsocketClient(apiKey, apiSecret)

ws.connect()
  .then(() => {
    ws.subscribe('executionReport', (msg) => {
      console.log('executionReport:', msg)
    })

    ws.subscribe('account_update', (msg) => {
      console.log('account_update:', msg)
    })
  })
  .catch(err => console.error(err))