Skip to content
DOCUMENTATION

How Bot Shaper works

You describe the strategy, Shaper builds a workflow of nodes, you test it in the practice account and, whenever you want, you move it to real money within your limits.

Getting started

  1. Describe your strategy in the chat with Shaper. For example: “Buy SOL when the 4h RSI drops below 30 and touches the lower Bollinger band. Take profit +5%.”
  2. Review the workflow in the editor. Every new workflow starts inactive and in the practice account.
  3. Test it with “Run once” or with a backtest of up to 5 years.
  4. Turn it on in practice. To move to real money you need an API key without withdrawal permission, two-step verification, and to type the bot's name.

Expressions

Every node has a label (velas for candles, rsi, voto for the committee vote…). Labels are identifiers, so the default ones are in Spanish; you can rename them. Any field can use the output of an earlier node by writing {etiqueta.campo}.

{rsi.value} < 30 and {velas.last.close} < {bb.lower}
{velas.close[-2]}            # second-to-last close
{voto.votes[0].confidence}   # first model's confidence
{params.tp_pct}              # workflow parameter

Operators: arithmetic, comparison, and, or, not. Functions: min, max, abs, round, pct_change, crossover(a, b), crossunder(a, b). You can only reference nodes that come earlier in the flow.

Node catalog

Trigger

NodeWhat it doesCredits
Scheduled
trigger.schedule
Cron or fixed interval0
Webhook
trigger.webhook
Launch the bot from a URL (TradingView alerts)0
Closed candle
trigger.candle_close
When a candle of the pair closes0
Price event
trigger.price_event
Level cross or change0

Data

NodeWhat it doesCredits
Price/candles
data.candles
OHLCV from an exchange0
Order book
data.orderbook
Depth and spread0
Funding and open interest
data.funding_oi
Derivatives by exchange0.2
News
data.news
Headlines with sentiment0.2
Social sentiment
data.social_sentiment
Mentions and tone0.2
On-chain data
data.onchain
Flows and large wallets0.2
My portfolio
data.portfolio
Balances and positions0

Indicators

NodeWhat it doesCredits
RSI
indicator.rsi
Relative strength0
EMA/SMA
indicator.ema_sma
Moving averages0
Bollinger
indicator.bollinger
Volatility bands0
MACD
indicator.macd
Moving average convergence0
ATR
indicator.atr
Average true range0
ADX
indicator.adx
Trend strength0
VWAP
indicator.vwap
Volume-weighted average price0
Relative volume
indicator.relative_volume
Volume vs. its average0
Custom indicator
indicator.custom
Your formula in Python1

AI

NodeWhat it doesCredits
LLM analyst
ai.analyst
One model analyzes and gives its viewdepends on model
Model committee
ai.committee
Several models votedepends on model
Bull/bear debate
ai.debate
Two agents arguedepends on model
Regime classifier
ai.regime
Trend, range or volatiledepends on model
Summary
ai.summary
Short text for alertsdepends on model

Logic

NodeWhat it doesCredits
Condition
logic.condition
Yes / no branch0
Score
logic.score
Weighted sum of signals0
Filter
logic.filter
Lets it through if met0
Merge
logic.merge
Joins several branches0
Wait
logic.wait
Pause or wait for an event0
Code (Python)
logic.code
Custom logic1

Decision

NodeWhat it doesCredits
Trade Gate
decision.trade_gate
Final decision gate0
Size by % of portfolio
decision.position_size
Calculates the quantity0
Cooldown
decision.cooldown
Avoids trading back to back0

Execution

NodeWhat it doesCredits
Market order
exec.market_order
Buy or sell now1
Limit order
exec.limit_order
At a set price1
Stop/Take profit (OCO)
exec.oco
Linked exits1
Close position
exec.close_position
Full or partial1
Rebalance portfolio
exec.rebalance
Goes back to the target weights1

Notification

NodeWhat it doesCredits
Telegram
notify.telegram
Message to your chat0
WhatsApp
notify.whatsapp
Message to your number0.1
Email
notify.email
To your email0
Slack
notify.slack
To a channel0
Outbound webhook
notify.webhook_out
POST to your URL0
Save to log
notify.log
Bot log0

Credentials and security

  • Your funds stay on your exchange. Bot Shaper never holds them.
  • Create the API key with read and trading permissions only. If we detect withdrawal permission, we don't store the key.
  • Keys are encrypted at rest and never shown again: you only see the last four characters.
  • You can restrict the key to our outbound IPs and rotate or revoke it from Integrations.

Credits

Every workflow run uses credits based on its nodes: AI nodes cost according to the model, premium data nodes 0.2 and orders 1. Before turning on a bot you see its estimated daily cost. If you run out of credits, bots pause without leaving orders half-done. See the plans in Pricing.

Docs: How to Build and Test Trading Bots | Bot Shaper