Neanderthals Paint Mammals


    0.1.1 • Public • Published


    CoinAPI is a node.js module for communicating with bitcoin and altcoin service providers. It provides a common API for interacting with various providers. Both request and response objects are normalized into a standard format for easy consumption.

    WARNING: The architecture and design of CoinAPI is still evolving. Many features are working as expected, but many are not yet complete. You are advised to use at your own risk. This readme will be updated as the project stablizes.


    • Common API for multiple bitcoin providers
    • Normalized request and response objects across providers
    • Extendable to work with any provider without requiring an accepted pull request
    • JSON Schema for all supported provider endpoints
    • JSON Schema based validation of both request and response objects
    • JSON Schema leveraged during normalization from native API objects to CoinAPI objects
    • Sandbox mode to help develop applications without actually making buy, sell, and other real life financial transactions
    • Full test suite


    The APIs of various service providers have been reviewed an analyzed for similar types of functionality. Endpoints of Coinbase, Bitstamp, Kraken, and BTC-e were reviewed. Based on the various endpoint, an attempt has been made to create a common API with consistent and sensible naming scheme.

    Supported providers

    • Coinbase
    • Bitstamp
    • Kraken (coming soon)

    Other providers

    In the future, additional providers may get native support in CoinAPI. However, CoinAPI was designed so that any provider can be used by simply creating a provier definition. This definition doesn't need to be included natively with CoinAPI for it to be used.

    Providers that get native support include:

    • BTC-e
    • Huobi
    • CampBX
    • Bitfinex

    Add a provider

    To add a provider, a provider definition must be created. This definition is primarily a configuration object that defines endpoints, attribute mapping, and any custom logic necessary.


    npm install coinapi


    To create a Provider instance:

    var coinapi = require('coinapi');
    var Provider = coinapi.Provider;
    var CoinbaseProvider = Provider.createClass({
      definition: coinapi.definitions.coinbase
    var coinbase = new CoinbaseProvider({
      key: process.env.COINBASE_API_KEY,
      secret: process.env.COINBASE_API_SECRET




    npm i coinapi

    DownloadsWeekly Downloads






    Last publish


    • tauren