Package Information
Available Nodes
Documentation
n8n-nodes-gainium
Automate your crypto trading strategies with Gainium using n8n β the powerful workflow automation tool. The n8n-nodes-gainium
package allows you to connect, trigger, and control your crypto trading bots, manage strategies, monitor deals, and more β all from inside n8n.
β‘ What is Gainium?
Gainium is a no-code automated crypto trading platform. It supports powerful features such as:
- Smart trading terminal
- Grid bots, DCA bots, and Combo bots
- Advanced backtesting and paper trading
- Real-time market screener
- Portfolio tracking
- Risk reduction and auto-compounding
- Webhook-triggered bot actions
π€ What is n8n?
n8n is a workflow automation tool that connects apps, APIs, and services. With this integration, you can build automated crypto trading workflows, connect your bots to alerts, signals, or analytics tools, and scale your trading systems without writing code.
π API Documentation
π Complete API Reference: https://api.gainium.io/api/docs/
π‘ Tip: The interactive API documentation includes detailed endpoint descriptions, request/response examples, and a built-in testing interface to help you understand and implement each feature.
π Features of n8n-nodes-gainium
This custom node package for n8n lets you:
- β Trigger trading bots on signals or events
- π Monitor open deals, positions, and PnL
- βοΈ Control bot actions (pause, resume, close deal, reduce position)
- π‘ Receive strategy alerts and automate responses
- π Get account and performance data in real-time
- π Combine with other nodes (Telegram, Discord, TradingView) for end-to-end crypto automation
π§ Use Cases
Take your crypto automation further by combining Gainium with other apps and logic inside n8n:
Portfolio Rebalancing Automation
Use market data from CoinGecko or your exchange to detect imbalances in your portfolio, then trigger fund movement across bots via Gainium API nodes.Automated Risk Reduction on News Events
Pull headlines from a news API. If negative sentiment is detected (e.g. using OpenAI or Google NLP), reduce exposure by pausing bots or reducing funds in active deals.Smart Profit Scheduling
Use a time-based trigger (cron) to reduce position size weekly, or increase bot aggressiveness during high-volume times.Dynamic Bot Settings Based on Volatility
Use a volatility indicator from an analytics service to dynamically adjust bot parameters like grid step, DCA scale, or max active deals via Gainium nodes.Multi-Exchange Arbitrage Alerting
Compare symbol prices across exchanges using Gainium + external APIs, and alert or trigger a deal if arbitrage opportunities are found.Telegram Bot for Manual Controls
Create a Telegram chatbot using n8n that lets you start/stop bots, view deal status, or pause all activity with simple text commands.Custom Risk Management Layer
Monitor your deal performance and close or scale down deals when they hit certain drawdown thresholds using Gainiumβs deal management endpoints.Automated Bot Deployment from Strategy Templates
Store strategy templates in Airtable or Notion. When conditions are met, create new bots with preconfigured settings using Gainiumβs bot creation node.Sync Gains to Notion or Google Sheets
Pull account and bot PnL data on a schedule and log it into Notion or Sheets for tracking, analysis, or client reporting.
π¦ Installation
In your n8n instance or custom Docker setup:
npm install n8n-nodes-gainium
Then restart your n8n server.
This is a community node. Youβll need to enable community nodes in your
n8n
settings.
π Authentication
Set your Gainium API Key in the credentials section of the node. You can create an API key in your Gainium account settings.
π§© Nodes Included
Each Gainium API endpoint has its own dedicated n8n node for maximum flexibility in your workflows.
Bots
- Get Grid Bots β /api/bots/grid
- Get Combo Bots β /api/bots/combo
- Get DCA Bots β /api/bots/dca
- Update DCA Bot β /api/updateDCABot
- Update Combo Bot β /api/updateComboBot
- Change Bot Pairs β /api/changeBotPairs
- Start Bot β /api/startBot
- Clone DCA Bot β /api/cloneDCABot
- Clone Combo Bot β /api/cloneComboBot
- Restore Bot β /api/restoreBot
- Stop Bot β /api/stopBot
- Archive Bot β /api/archiveBot
Deals
- Get Deals β /api/deals
- Update DCA Deal β /api/updateDCADel
- Update Combo Deal β /api/updateComboDeal
- Add Funds to Deal β /api/addFunds
- Reduce Funds from Deal β /api/reduceFunds
- Start Deal β /api/startDeal
- Close Deal β /api/closeDeal/{dealId}
User
- Get User Exchanges β /api/user/exchanges
- Get User Balances β /api/user/balances
General
- Get Supported Exchanges β /api/exchanges
- Get Crypto Screener β /api/screener
More coming soon.
π§ Gainium Agent Tool
The Gainium Agent Tool is a special-purpose node designed for AI agents in n8n.
It allows agentsβlike those built using OpenAI or Anthropic βto dynamically decide what actions to take and pull data from your Gainium account in real time.
This enables next-level automation where AI can act as your trading assistant, making decisions based on logic, data, and goalsβnot just static flows.
π‘ Example Workflows
TradingView to Bot
Use a webhook in n8n to catch a signal from TradingView, then start a Combo bot.Auto Reduce Risk
Monitor BTC dominance with a third-party API. If it spikes, pause all bots or reduce open positions using Gainium Bot Action node.Telegram Profit Alerts
Send a message when a deal closes with over 5% profit using the Deal Monitor node + Telegram node.Crypto Market Screening & Alerts
Use the Crypto Screener to find coins matching specific criteria (e.g., high volume, low market cap, recent price spikes). Filter results and automatically create new bots for promising opportunities, or send alerts when screening conditions are met.AI Agent as Trading Assistant
Connect an OpenAI agent to Gainium using the Agent Tool node. Let the agent fetch live deal data and decide whether to reduce risk, pause bots, or rebalance positions.Natural Language Bot Control
Let users type plain English into Telegram or Slack (e.g. βPause all BTC botsβ). An agent interprets the message and triggers the correct Gainium action node.Adaptive Strategy Execution
Use a LangChain agent to monitor volatility and volume metrics from multiple sources. Based on the data, it can update bot settings like DCA scale or grid step size dynamically.
π Support
Need help or feature requests?
Open an issue here or connect via the Gainium Community.
π§βπ» Contributing
- Fork this repo
- Make your changes
- Submit a PR
Letβs build better automation for crypto traders together.
π§ Keywords
crypto automation, automated trading, n8n crypto bots, trading bot automation, crypto trading bots, Gainium integration, grid bot automation, DCA bot automation, combo bot strategy, n8n gainium plugin, webhook crypto bot, algo trading n8n, automated crypto signals, n8n crypto integration, risk management crypto bots, auto-compounding trading bot, crypto trading workflow, crypto screener