n8n-nodes-crypto-com-exchange

[Velocity BPA Licensing Notice]

This n8n node is licensed under the Business Source License 1.1 (BSL 1.1).

Use of this node by for-profit organizations in production environments requires a commercial license from Velocity BPA.

For licensing information, visit https://velobpa.com/licensing or contact licensing@velobpa.com.

A comprehensive n8n community node for Crypto.com Exchange providing spot trading, derivatives, margin trading, wallet management, and market data operations with HMAC-SHA256 authentication.

Features

• Spot Account Management: View balances, transaction history, deposit/withdrawal operations
• Spot Trading: Place orders (limit, market, stop), cancel orders, view order history and trades
• Derivatives Trading: Manage positions, transfers between spot and derivatives accounts
• Margin Trading: Borrow/repay funds, view loan and interest history
• Market Data: Access real-time tickers, order books, candlesticks, and instrument data
• Wallet Operations: Manage deposit addresses, withdrawals across multiple networks
• HMAC-SHA256 Authentication: Secure API authentication with proper signature generation
• Comprehensive Error Handling: All Crypto.com API error codes properly mapped

Installation

Community Nodes (Recommended)

1. Open your n8n instance
2. Go to Settings > Community Nodes
3. Click Install a community node
4. Enter n8n-nodes-crypto-com-exchange
5. Click Install

Manual Installation

# Navigate to your n8n installation directory
cd ~/.n8n

# Install the package
npm install n8n-nodes-crypto-com-exchange

Development Installation

# 1. Extract the zip file
unzip n8n-nodes-crypto-com-exchange.zip
cd n8n-nodes-crypto-com-exchange

# 2. Install dependencies
npm install

# 3. Build the project
npm run build

# 4. Create symlink to n8n custom nodes directory
# For Linux/macOS:
mkdir -p ~/.n8n/custom
ln -s $(pwd) ~/.n8n/custom/n8n-nodes-crypto-com-exchange

# For Windows (run as Administrator):
# mklink /D %USERPROFILE%\.n8n\custom\n8n-nodes-crypto-com-exchange %CD%

# 5. Restart n8n
n8n start

Credentials Setup

Creating API Credentials

1. Log in to Crypto.com Exchange
2. Navigate to Settings > API Management
3. Create a new API key with the required permissions
4. Save both the API Key and Secret Key securely

Configuring in n8n

Note: For security, store your API credentials securely and never share them.

Resources & Operations

Spot Account (7 operations)

Spot Trading (7 operations)

Derivatives (5 operations)

Margin (6 operations)

Market Data (7 operations)

Wallet (5 operations)

Usage Examples

Get Account Balance

// Configure the node:
// Resource: Spot Account
// Operation: Get Account Summary
// Returns all currency balances

Place a Limit Order

// Configure the node:
// Resource: Spot Trading
// Operation: Create Order
// Instrument Name: BTC_USDT
// Side: BUY
// Type: LIMIT
// Quantity: 0.001
// Price: 40000

Get Market Data

// Configure the node:
// Resource: Market Data
// Operation: Get Candlestick
// Instrument Name: BTC_USDT
// Timeframe: 1h
// Options:
//   Count: 100

API Concepts

Instrument Names

Trading pairs are formatted as BASE_QUOTE, for example:

• BTC_USDT - Bitcoin/Tether
• ETH_USDT - Ethereum/Tether
• CRO_USDT - Cronos/Tether

Order Types

Time in Force

Candlestick Timeframes

Supported intervals: 1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 1D, 7D, 14D, 1M

Error Handling

The node handles all Crypto.com API error codes:

Security Best Practices

1. API Key Permissions: Only enable the permissions you need
2. IP Whitelisting: Restrict API access to specific IPs
3. Credential Storage: Use n8n's credential system, never hardcode
4. Test Environment: Test with small amounts first
5. Rate Limiting: Be aware of API rate limits to avoid blocks

Development

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint code
npm run lint

# Fix linting issues
npm run lint:fix

# Watch mode for development
npm run dev

Author

Velocity BPA

• Website: velobpa.com
• GitHub: Velocity-BPA

Licensing

This n8n community node is licensed under the Business Source License 1.1.

Free Use

Permitted for personal, educational, research, and internal business use.

Commercial Use

Use of this node within any SaaS, PaaS, hosted platform, managed service,
or paid automation offering requires a commercial license.

For licensing inquiries:
licensing@velobpa.com

See LICENSE, COMMERCIAL_LICENSE.md, and LICENSING_FAQ.md for details.

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Support

• Issues: GitHub Issues
• Documentation: Crypto.com Exchange API
• Email: support@velobpa.com

Acknowledgments

• Crypto.com for their comprehensive Exchange API
• n8n for the workflow automation platform
• The n8n community for their continued support