js-exchanges-connector

An open source JavaScript library for fetching cryptocurrency exchanges

Instalation

yarn add @coinsamba/js-exchanges-connector

or

npm i @coinsamba/js-exchanges-connector

Usage

Import your favorite exchange connector

import { bitpreco } from '@coinsamba/js-exchanges-connector';

Getters: all connectors have this same getters used to verify if the connector have an implementation of desired method.

/**
 * will return true if this exchange has the method that return all tickers with all available quote
 */
console.log(bitpreco.hasAllTickers);

/**
 * will return true if this exchange has the method that return all tickers with specific quote as argument
 */
console.log(bitpreco.hasAllTickersByQuote);

import { pagcripto, binance } from '@coinsamba/js-exchanges-connector';

pagcripto.getTicker('BTC', 'BRL').then(ticker => console.log(ticker));
// will return the ticker in the specified market
// {
//     exchangeId: "pagcripto",
//     base: "BTC",
//     quote: "BRL",
//     last: 100000,
//     ask: 100000,
//     bid: 100000,
//     vol: 16,
// }

pagcripto.getBook('BTC', 'BRL').then(book => console.log(book));
// will return orderbook of specified market
// {
//     asks: [{price: 1000, amount: 1}],
//     bids: [{price: 1000, amount: 1}],
// }


pagcripto.getAllTickersByQuote('BRL').then(tickers => console.log(tickers));
// will return all tickers in the specified market
// [
//     {
//         exchangeId: "pagcripto",
//         base: "BTC",
//         quote: "BRL",
//         last: 100000,
//         ask: 100000,
//         bid: 100000,
//         vol: 16,
//     },
//     {
//         exchangeId: "pagcripto",
//         base: "ETH",
//         quote: "BRL",
//         last: 100000,
//         ask: 100000,
//         bid: 100000,
//         vol: 16,
//     }
// ]


binance.getAllTickers().then(tickers => console.log(tickers));
// will return all tickers in all markets
// [
//     {
//         exchangeId: "binance",
//         base: "BTC",
//         quote: "BRL",
//         last: 100000,
//         ask: 100000,
//         bid: 100000,
//         vol: 16,
//     },
//     {
//         exchangeId: "binance",
//         base: "ETH",
//         quote: "BTC",
//         last: 100000,
//         ask: 100000,
//         bid: 100000,
//         vol: 16,
//     }
// ]

Custom fetcher

You can use a custom fetcher, just create a class that implement ICustomFetcher interface, and call FetcherHandler.setFetcher(new MyFetcher()); to start using your custom fetcher. This is cool because you can define proxy or any different strategy to fetch the exchanges APIs.

import {
  FetcherHandler,
} from "@coinsamba/js-exchanges-connector";
import {
  FetcherArgs,
  FetcherRequisitionMethods,
  ICustomFetcher,
} from "@coinsamba/js-exchanges-connector/types";
import Axios, { AxiosError } from "axios";

export class MyFetcher implements ICustomFetcher {
  private parseAxiosError(e: AxiosError) {
    let message = `E - ${e.code}`;
    if (e.response) {
      message += ` - ${e.response.status} - ${e.config!.url} ${
        typeof e.response.data === "object"
          ? `- ${JSON.stringify(e.response.data)}`
          : ""
      }`;
    } else {
      message += ` - ${e.config!.url}`;
    }
    return new Error(message);
  }

  // fetch must handle with get and post methods
  // must be able to receive string paramter and handle as GET method
  async fetch<ResponseType>(args: FetcherArgs): Promise<ResponseType> {
    try {
      if (typeof args == "string") {
        const { data } = await Axios.get<ResponseType>(args);
        return data;
      } else {
        const { data } = await Axios.request<ResponseType>({
          headers: args.headers,
          url: args.url,
          method: args.method,
          [args.method === FetcherRequisitionMethods.GET ? "params" : "data"]:
            args.data,
        });
        return data;
      }
    } catch (error: any) {
      throw this.parseAxiosError(error as unknown as AxiosError);
    }
  }
}


FetcherHandler.setFetcher(new MyFetcher());

Who is using?

• Coinsamba

Implementations

id	getTicker	getAllTickers	getAllTickersByQuote	getBook
binance_us 🇺🇸	✓	✓		✓
binance 🌐	✓	✓		✓
bisq 🌐	✓			✓
bitbay	✓			✓
bitblue 🇧🇷	✓			✓
bitcointoyou 🇧🇷	✓			✓
bitcointrade 🇧🇷	✓			✓
bitget 🌐		✓		✓
bitmonedero 🇦🇷	✓			✓
bitnuvem 🇧🇷	✓			✓
bitpreco 🇧🇷	✓		✓	✓
bitso 🇲🇽	✓			✓
bitstamp	✓			✓
brasilbitcoin 🇧🇷	✓			✓
buda 🇨🇴🇵🇪🇦🇷🇨🇱	✓			✓
cexio 🌐	✓		✓	✓
citcoin 🇧🇷	✓			✓
coinbase_pro	✓			✓
coinext 🇧🇷	✓		✓	✓
coinsbank 🌐	✓			✓
cryptomarket 🇦🇷	✓			✓
decrypto 🇦🇷				✓
exmo 🌐	✓	✓		✓
flowbtc 🇧🇷	✓		✓	✓
foxbit 🇧🇷	✓	✓		✓
gateio 🌐	✓	✓		✓
isbit 🇲🇽	✓			✓
isistrade 🇧🇷			✓	✓
kraken 🌐	✓			✓
kucoin 🌐	✓	✓		✓
luno 🇿🇦			✓	✓
mercadobitcoin 🇧🇷	✓	✓		✓
novadax 🇧🇷	✓	✓		✓
noxbitcoin 🇧🇷	✓
okx 🌐	✓	✓		✓
pagcripto_otc 🇧🇷	✓			✓
pagcripto 🇧🇷	✓		✓	✓
paxos 🌐	✓			✓
poloniex 🌐	✓	✓		✓
quidax 🇳🇬			✓	✓
satoshitango 🇦🇷			✓	✓
trubit 🌐	✓	✓		✓
upcambio 🇧🇷	✓			✓

Known Whitelabel Platforms

• alphapoint
• bnb
• peatio
• upex