nestjs-ccxt

:star: Star me on GitHub — it motivates me a lot!

CCXT module for NestJS framework with exchange markets cache for better performance. :rocket::rocket:

Installation

1$ npm i --save nestjs-ccxt ccxt

Getting started

Firstly import CcxtModule with CcxtModule.forRoot(...) or CcxtModule.forRootAsync(...). Check out the module configuration options

1import { CcxtModule } from 'nestjs-ccxt';
2
3@Module({
4  imports: [CcxtModule.forRoot({ ... })],
5})
6export class AppModule {}

Next, inject CcxtService using normal constructor injection.

1@Injectable()
2export class ExchangeService {
3  constructor(private ccxtService: CcxtService) {}
4
5  async getMarkets() {
6    const client = await this.ccxtService.getClient('binance');
7    return client.markets;
8  }
9}

Configuration

nestjs-ccxt can be configured with a variety of options. To configure the underlying Ccxt instance, pass an optional ccxtOptions object to the forRoot() method of CcxtModule when importing it. This options object will be passed directly to the underlying Ccxt constructor.

1interface Params {
2  /**
3   * Optional parameters for the underlying Ccxt instance
4   * @see https://docs.ccxt.com/en/latest/manual.html#instantiation
5   */
6  ccxtOptions?: Partial<ccxt.Exchange>;
7
8  /**
9   * Default exchanges to be loaded on start up
10   * Default: undefined
11   */
12  defaultExchanges?: ccxt.ExchangeId | ccxt.ExchangeId[];
13
14  /**
15   * If `true`, the markets data of the exchanges setted in the `defaultExchanges`
16   * options are loaded on startup
17   * Default: true
18   */
19  loadMarketsOnStartup?: boolean;
20
21  /**
22   * Markets data cache expiration. Set this value to 0 (zero)
23   * to disable caching markets data
24   * Default: 3600000 (1 hour => 60 * 60 * 1000)
25   */
26  marketsCacheExpireMs?: number;
27
28  /**
29   * Enable the Testnet if supported by the underlying exchange
30   * Default: false
31   */
32  sandboxMode?: boolean;
33
34  /**
35   * If `true`, ccxt logs every HTTP requests to stdout
36   * Default: false
37   */
38  verbose?: boolean;
39}

An optional options object can be passed in the getClient() method of CcxtService. This options object will be passed directly to the underlying Ccxt constructor.

1const client = await this.ccxtService.getClient('binance', {
2  apiKey: 'YOUR_API_KEY',
3  secret: 'YOUR_SECRET',
4});

Contributing

I would greatly appreciate any contributions to make this project better. Please make sure to follow the below guidelines before getting your hands dirty.

1. Fork the repository
2. Create your branch (git checkout -b my-branch)
3. Commit any changes to your branch
4. Push your changes to your remote branch
5. Open a pull request

Donation

If this project help you reduce time to develop, you can give me a cup of coffee 🍵 :)

ETH: 0xEE45AA08D65352d49344f42d9E0EAf14AA3D812d

License

Copyright Andrea Fassina, Licensed under MIT.