Ecnanib is an automated cryptocurrency trading platform for Binance. It lets you create and manage trading bots that execute strategies 24/7, with built-in risk management and real-time monitoring.

Quick Start

1. Create an account — Register with your email and a strong password.
2. Connect your Binance API keys — Go to Settings → API Keys and add your Binance API key and secret. Enable "Spot Trading" permissions on Binance but keep "Withdrawals" disabled for safety.
3. Create a bot — Use the Bot Wizard to pick a trading pair, strategy, and risk limits.
4. Monitor — Watch your bot's performance on the Dashboard with real-time updates.

The Dashboard is your central control panel. It displays:

• Total Balance — The combined investment amount across all your bots.
• 24h PnL — Profit and loss over the last 24 hours.
• Active Bots — Number of bots currently running.
• Recent Trades — The latest trade executions with price, quantity, and realized PnL.
• Portfolio Allocation — A breakdown of investment across bots.
• Equity Curve — A chart showing cumulative PnL over time based on your trades.
• Kill All Bots — An emergency button that immediately stops all running bots and cancels their open orders.

Data updates in real time via SignalR, so you don't need to refresh the page.

The Bot Wizard walks you through creating a new trading bot in five steps:

1. Select Trading Pair — Choose a bot name, trading pair (e.g., BTCUSDT, ETHUSDT), market type (Spot or USDT Futures), and kline interval. For futures, you can also set leverage (1x–125x) and margin type (Isolated or Cross).
2. Choose Strategy — Pick a trading strategy. See the Trading Strategies section for details on each.
3. Strategy Parameters — Configure strategy-specific settings. Defaults are provided for each strategy.
4. Risk Limits & Investment — Set your investment amount, stop-loss, take-profit, daily loss limit, trailing stop, and max exposure. Select which Binance API key to use.
5. Review & Confirm — Review your configuration. Optionally check "Start bot immediately after creation" to launch it right away.

After creation, you can start, pause, or stop your bot from the Bots page.

Ecnanib supports nine trading strategies. Each strategy has its own parameters and is suited to different market conditions.

Places buy and sell orders at preset grid levels within a defined price range. Profits from price oscillation in sideways markets by repeatedly buying low and selling high within the grid.

Parameters

Opens a base order, then places additional safety orders as the price drops. This averages down your entry price and takes profit when the price rebounds.

Parameters

Buys when the RSI indicator drops into oversold territory and sells when it rises into overbought territory. Works best in ranging or mean-reverting markets.

Parameters

Buys on a golden cross (fast MA crosses above slow MA) and sells on a death cross (fast MA crosses below slow MA). Effective for capturing trends in trending markets.

Parameters

Enters a position and then trails the price upward. If the price drops by the callback rate from its highest point, the position is sold. This locks in profits during uptrends while limiting downside.

Parameters

Generates buy signals on bullish crossovers (MACD line crosses above the signal line) and sell signals on bearish crossovers (MACD line crosses below the signal line). The histogram strength is used to gauge signal confidence.

Parameters

A mean-reversion strategy that buys when price touches or crosses the lower band (oversold) and sells when price touches or crosses the upper band (overbought). Uses the Bollinger %B indicator to measure signal strength.

Parameters

Uses Google Gemini to analyze candlestick data and generate buy, sell, or hold signals with confidence scores. The AI considers multiple technical factors and market context to make trading decisions.

Requires a Gemini API key. You can add your own key via Settings → API Keys in the Gemini AI Keys section. Each key is encrypted at rest using AES-256-GCM, just like Binance API keys. You can also configure per-key settings:

When creating a Gemini AI bot in the Bot Wizard, you must select which Gemini key to use. A per-user key is required — bots cannot use the Gemini AI strategy without one.

Bot Wizard Options

In addition to the per-key settings above, the Bot Wizard offers these per-bot options for Gemini AI:

Write your own trading logic in C#. Your script receives a ScriptContext global object containing the current candlestick, up to 100 historical candles, and pre-computed indicator values. Return a Signal with a Buy, Sell, or Hold action.

Available Helpers

• Hold(reason) — Create a hold signal.
• Buy(strength, reason, orderType, limitPrice, quantity) — Create a buy signal.
• Sell(strength, reason, orderType, limitPrice, quantity) — Create a sell signal.

Security

Scripts run in a sandbox with limited namespace access (System, System.Linq, System.Collections.Generic, and Ecnanib domain types). File I/O, networking, reflection, and process management are blocked. Each script execution has a 100ms timeout. Scripts are compiled at bot startup, so compilation errors surface immediately.

Every bot runs through a risk management pipeline before executing trades. The following protections are available:

Risk limits are configured per bot during creation and can be updated from the bot detail page.

Backtesting lets you test a strategy against historical data before risking real capital.

How to Run a Backtest

1. Go to the Backtest page.
2. Select a trading pair and date range.
3. Choose a strategy and configure its parameters.
4. Set risk limits (stop-loss, take-profit, etc.).
5. Optionally set Leverage (1x for spot, higher values simulate futures leverage).
6. Click Run Backtest.

Interpreting Results

• Total Return — Overall percentage gain or loss.
• Win Rate — Percentage of trades that were profitable.
• Max Drawdown — Largest peak-to-trough decline during the backtest period.
• Sharpe Ratio — Risk-adjusted return (higher is better, annualized).
• Sortino Ratio — Like Sharpe but only penalizes downside volatility (annualized).
• Profit Factor — Gross profit divided by gross loss. Values above 1.0 indicate profitability.
• Avg Trade Duration — Average holding period across all trades.
• Total Trades — Number of trades executed during the simulation.
• Equity Curve — Visual chart showing portfolio value over time.

Note: Past performance does not guarantee future results. Backtests use historical data and do not account for slippage, partial fills, or exchange downtime.

The Backtest Comparison page lets you select 2–4 previous backtest results and view them side by side. A comparison table highlights the best performer in each metric (PnL, Win Rate, Sharpe Ratio, Sortino Ratio, Max Drawdown, Profit Factor, and more), making it easy to evaluate which strategy or configuration performed best.

Creating Binance API Keys

1. Log in to your Binance account.
2. Go to API Management in your account settings.
3. Create a new API key with a descriptive label.
4. Enable Spot Trading permission.
5. Restrict the key to your server's IP address for extra security.
6. Do not enable Withdrawal permissions.

Adding Binance Keys to Ecnanib

1. Go to Settings → API Keys.
2. Click Add API Key.
3. Enter your API key and secret.
4. The key is saved and your secret is encrypted immediately.

Adding Gemini AI Keys

1. Get an API key from Google AI Studio.
2. Go to Settings → API Keys and scroll to the Gemini AI Keys section.
3. Enter a label and your API key. Optionally configure the model, temperature, and minimum confidence threshold.
4. Click Test to verify the key works before using it in a bot.

When creating a Gemini AI bot, you must select a Gemini key in the Bot Wizard. Each bot stores a reference to the key, so you can use different keys (or different model settings) for different bots. If you delete a Gemini key, bots using it will not be able to start until a new key is assigned.

Security

Both Binance and Gemini API keys are encrypted at rest using AES-256-GCM with HKDF key derivation. Plaintext keys are never stored in the database. Only the encrypted ciphertext is persisted, and decryption happens in memory only when needed (to sign Binance requests or call the Gemini API).