Coinbase Pro API for Node.js, written in TypeScript and covered by tests.
npm install coinbase-pro-node> [!IMPORTANT]
> On 2022-06-22 Coinbase announced that it will discontinue the Pro API in favor of its Advanced Trade API.
>
> With this news the coinbase-pro-node package, which has been serving users effectively since 2019-04-11, will become non functional.
>
> Luckily, the code of this library is open-source, allowing you to fork it and tailor it to the new Advanced Trade API. Coinbase offers a Pro to Advanced Trade API Mapping guide to assist in this process.
!Language Details !Code Coverage !License !Package Version
---
š _Better than the original Coinbase API. See why._ š
Community-maintained [Coinbase API][1] for Node.js & Deno, written in TypeScript and covered by tests.
The purpose of this [coinbase-pro-node][5] package is to maintain a recent Coinbase API for Node.js with type safety through TypeScript.
- ā
Typed. Source code is 100% TypeScript. No need to install external typings.
- ā
Tested. Code coverage is 100%. No surprises when using "coinbase-pro-node".
- ā
Convenient. Request throttling is built-in. Don't worry about rate limiting.
- ā
Comfortable. More than an API client. You will get extras like candle watching.
- ā
Maintained. Automated security updates. No threats from outdated dependencies.
- ā
Documented. Get started with [demo scripts][3] and [generated documentation][4].
- ā
Modern. HTTP client with Promise API. Don't lose yourself in callback hell.
- ā
Robust. WebSocket reconnection is built-in. No problems if your Wi-Fi is gone.
- ā
Reliable. Following [semantic versioning][8]. Get notified about breaking changes.
npm
``bash`
npm install coinbase-pro-node
Yarn
`bash`
yarn add coinbase-pro-node
JavaScript
`javascript`
const {CoinbasePro} = require('coinbase-pro-node');
const client = new CoinbasePro();
TypeScript
`typescript`
import {CoinbasePro} from 'coinbase-pro-node';
const client = new CoinbasePro();
The [demo section][3] provides many examples on how to use "coinbase-pro-node". There is also an automatically generated [API documentation][4]. For a quick start, here is a simple example for a REST request:
`typescript
import {CoinbasePro} from 'coinbase-pro-node';
// API Keys can be generated here:
// https://pro.coinbase.com/profile/api
// https://public.sandbox.pro.coinbase.com/profile/api
const auth = {
apiKey: '',
apiSecret: '',
passphrase: '',
// The Sandbox is for testing only and offers a subset of the products/assets:
// https://docs.cloud.coinbase.com/exchange/docs#sandbox
useSandbox: true,
};
const client = new CoinbasePro(auth);
client.rest.account.listAccounts().then(accounts => {
const message = You can trade "${accounts.length}" different pairs.;`
console.log(message);
});
If you want to listen to WebSocket messages, have a look at these demo scripts:
- Subscribe to "ticker" channel (real-time price updates)
- Subscribe to authenticated "user" channel
All [demo scripts][3] are executable from the root directory. If you want to use specific credentials with a demo script, simply add a .env file to the root of this package to modify environment variables used in init-client.ts.
`bash`
npx ts-node ./src/demo/dump-candles.ts
Tip: There is a .env.defaults file which serves as a template. Just remove its .defaults extension and enter your credentials to get started. Do not commit this file (or your credentials) to any repository!
The "coinbase-pro-node" library was built to be used in Node.js environments BUT you can also make use of it in web frontend applications (using React, Vue.js, etc.). However, due to the CORS restrictions of modern web browser, you will have to use a proxy server.
A proxy server can be setup with webpack's DevServer proxy configuration or http-proxy-middleware.
Here is an example:
Backend
`typescript
import {createProxyMiddleware} from 'http-proxy-middleware';
import express from 'express';
const app = express();
app.use(
'/api-coinbase-pro',
createProxyMiddleware({
target: 'https://api.exchange.coinbase.com',
changeOrigin: true,
pathRewrite: {
[^/api-coinbase-pro]: '',`
},
})
);
Later on, you can use the proxy URL (/api-coinbase-pro from above) in your web application to initialize "coinbase-pro-node" with it:
Frontend
`typescript`
const client = new CoinbasePro({
httpUrl: '/api-coinbase-pro',
apiKey: '',
apiSecret: '',
passphrase: '',
useSandbox: false,
});
Checkout [GitHub's dependency graph][6] to see who uses "coinbase-pro-node" in production. There are also [npm packages][7] depending on "coinbase-pro-node".
[![Benny Neugebauer on Stack Exchange][stack_exchange_bennyn_badge]][stack_exchange_bennyn_url]
Contributions, issues and feature requests are welcome!
Feel free to check the issues page.
The following commits will help you getting started quickly with the code base:
- Add REST API endpoint
- Add REST API endpoint (with fixtures)
All resources can be found in the [Coinbase Exchange API reference][2]. For the latest updates, check [Coinbase's API Changelog][9].
This project is MIT licensed.
Please leave a star if you find this project useful.
If you like this project, you might also like these related projects:
- trading-signals, Technical indicators, written in TypeScript, with arbitrary-precision arithmetic.
- ig-trading-api, REST API, written in TypeScript, for CFD trading with IG.
- binance-api-node, Heavily tested and Promise-based Binance API with TypeScript definitions.
---
There are official Coinbase APIs for Node.js, but they all come with some disadvantages leading to decreased developer experience (DX):
1. Coinbase's first Node.js API has no type safety and got deprecated on July, 19th 2016
2. Coinbase's second Node.js API has no type safety and got deprecated on January, 16 2020
3. Coinbase's current Node.js API (OAS spec) still lacks type safety and does not incorporate best practices like automatic reconnections and request throttling
Coinbase is versioning its API through ReadMe.com, so you can generate an API client from their OpenAPI Specification. ReadMe provides a Node.js package named "api" which allows you to retrieve an automatically generated Node.js client:
`bash`
npm install api@^4.5.1
`ts
import api from 'api';
const sdk = api('@coinbase-exchange/v1.0#qgumw1pl3iz4yut');
sdk'ExchangeRESTAPI_GetProductTrades'.then(response => {
console.log(Found "${response.length}" trades.);``
});
The current Coinbase Node.js SDK (provided by the api package) does not support typings for response payloads:
[1]: https://pro.coinbase.com/
[2]: https://docs.cloud.coinbase.com/exchange
[3]: https://github.com/bennycode/coinbase-pro-node/tree/main/src/demo
[4]: https://bennycode.com/coinbase-pro-node
[5]: https://www.npmjs.com/package/coinbase-pro-node
[6]: https://github.com/bennycode/coinbase-pro-node/network/dependents
[7]: https://www.npmjs.com/browse/depended/coinbase-pro-node
[8]: https://docs.npmjs.com/about-semantic-versioning
[9]: https://docs.cloud.coinbase.com/exchange/docs/changelog
[stack_exchange_bennyn_badge]: https://stackexchange.com/users/flair/203782.png?theme=default
[stack_exchange_bennyn_url]: https://stackexchange.com/users/203782/benny-neugebauer?tab=accounts