Binance connector in Typescript

This library is an easy, simple and clean connector to the Binance public API. It is divided into three distinct endpoints:

• RESTful API

• Websocket API

• Websocket Stream

• Supported APIs:

  • /api/*
  • /sapi/*

• Inclusion of test cases and examples

• Request and response types

Installation

1npm install @binance/connector-typescript

Documentation

RESTful APIs

All REST API endpoints are linked to a unique module called Spot. To start working with the REST API, you will need to import and create the client. Keep in mind that some of the endpoints require authentication with your API credentials keys:

1import { Spot } from '@binance/connector-typescript';
2
3const API_KEY = '';
4const API_SECRET = '';
5const BASE_URL = 'https://api.binance.com';
6
7const client = new Spot(API_KEY, API_SECRET, { baseURL: BASE_URL });
8client.exchangeInformation().then((res) => {
9    // console.log(res);
10}).catch(err => { 
11// console.log(err)
12});

Please look at examples/restful folder to check for more endpoints.

Testnet

While /sapi/* endpoints don't have testnet environment yet, /api/* endpoints can be tested in Spot Testnet. You can use it by changing the base URL:

1// provide the testnet base url
2const client = new Spot(apiKey, apiSecret, { baseURL: 'https://testnet.binance.vision'})

If base_url is not provided, it defaults to api.binance.com.

Websockets

Websocket API Client

All websocket are available with the WebsocketAPI module. To work with the websocket API, you will need to import the client and generate a callBack function to handle the messages:

1import { WebsocketAPI } from '@binance/connector-typescript';
2
3const API_KEY = '';
4const API_SECRET = '';
5
6const callbacks = {
7    open: (client: WebsocketAPI) => client.exchangeInfo(),
8    close: () => {
9      // console.debug('Disconnected from WebSocket server')
10    },
11    message: (data: string) => {
12      // console.info(JSON.parse(data))
13    }
14}
15const websocketAPIClient = new WebsocketAPI(API_KEY, API_SECRET, { callbacks });
16setTimeout(() => websocketAPIClient.disconnect(), 20000);

Please look at examples/websocketAPI folder to check for more endpoints.

Websocket Stream Client

All websocket streams are available with the WebsocketStream module. To work with the websocket API, you will need to import the client and generate a callBack function to handle the messages:

1import { WebsocketStream } from '@binance/connector-typescript';
2
3const callbacks = {
4  open: () => {
5    // console.debug('Connected to WebSocket server')
6  },
7  close: () => {
8    // console.debug('Disconnected from WebSocket server')
9  },
10  message: (data: string) => {
11    // console.info(data)
12  },
13}
14
15const websocketStreamClient = new WebsocketStream({ callbacks });
16websocketStreamClient.aggTrade('bnbusdt');
17setTimeout(() => websocketStreamClient.disconnect(), 6000);

Please look at examples/websocketStream folder to check for more endpoints.

Test

1npm install
2
3npm run test

Limitation

Futures and European Options APIs are not supported:

• /fapi/*
• /dapi/*
• /eapi/*
• Associated Websocket Market and User Data Streams

License

MIT