coin-ticker
v3.2.0
Published
Wrapper for bitcoin exchange apis. The easiest way to add cryptocurrency market data into your application!
Downloads
159
Maintainers
Readme
coin-ticker
Easily get the latest exchange data of Bitcoin, Etherium, Litecoin, and other assets from a variety of exchanges including Bitfinex, Coinbase, Bitstamp, Kraken, Poloniex and others.
Install
$ npm install coin-ticker
Usage
Require:
const coinTicker = require('coin-ticker');
Syntax:
coinTicker([exchange, assetPair])
Get available exchanges:
The coinTicker function with no arguments will return an array of all available exchanges
coinTicker()
// =>
// [
// 'bitfinex',
// 'coinbase',
// 'bitstamp',
// 'kraken',
// 'okcoin',
// 'exmo',
// 'bittrex',
// 'poloniex',
// 'bitcoinaverage',
// 'gdax',
// ]
Get available asset pairs by exchange:
Declare the exchange and use string 'pairs' to request available asset pairs. coinTicker will return a promise.
coinTicker('poloniex', 'pairs')
.then((pairs) => {
console.log(pairs);
})
// =>
// [
// 'BCN_BTC',
// 'BELA_BTC',
// 'BLK_BTC',
// 'BTCD_BTC',
// 'BTM_BTC',
// 'BTS_BTC',
// 'BURST_BTC',
// 'CLAM_BTC',
// 'DASH_BTC',
// 'DGB_BTC',
// 'DOGE_BTC',
// 'EMC2_BTC',
// 'FLDC_BTC',
// 'FLO_BTC',
// 'GAME_BTC',
// 'GRC_BTC',
// 'HUC_BTC',
// 'LTC_BTC',
// 'MAID_BTC',
// 'OMNI_BTC',
// ...
// ]
Get Ticker Data:
Simply declare the exchange and asset pair to get the latest market info. coinTicker will return a promise.
coinTicker('bitfinex', 'BTC_USD')
// => Promise
Response Data:
An object containing the following values:
{
last: // the last traded price
ask: // current ask
bid: // current bid
low: // 24 hour low
high: // 24 hour high
vol: // 24 hour volume
timestamp: // precise time
exchange: // the current exchange, i.e. 'bitfinex'
pair: // the asset pair, i.e. 'BTC_USD'
rawData: // the original, unformatted object received from the exchange api. Differs by exchange.
}
Example:
coinTicker('bitfinex', 'BTC_USD')
.then((tick) => {
console.log(tick)
})
// =>
// {
// last: '1034.8',
// ask: '1034.8',
// bid: '1034.7',
// low: '1001.6',
// high: '1040.0',
// vol: '15112.8733725',
// timestamp: '1486238356.227418953',
// exchange: 'bitfinex',
// pair: 'BTC_USD',
// rawData: { ... }
// }
If you find this package useful, please contribute by donating or opening a pull request.
BTC:
1Gr9UcXdM5Kmnseht2u29o1SsqMnBkTsYP
ETH:
0xc519a1904c5a9D99C13374d22388091B807c54cF