My Bots

My Bots are your own trading bots. You run the strategy, in TradingView or in your own code. OptAlgo receives its signals by webhook and executes them on your connected exchange, or on paper.

Every bot has a strategy key (shown in the app as the bot's key). Each signal carries it in the strategy_key field, and that is how OptAlgo knows which bot the signal is for. Signals are sent to:

POST https://api.optalgo.com/signal-listener/signal

Keep your strategy key private

The key does not expire. It stays valid until the bot is deleted, and anyone who has it can send signals to your bot. Do not paste it into public scripts, screenshots or chats.

Bot types

Type	Trades	Configured by	Best for
Single-symbol bot	One symbol on one exchange and market type	You, when you create it	One strategy on one chart
Auto bot	One symbol	Its first signal	Creating the bot first and letting the alert fill in the details
Multi-symbol bot	Any number of symbols on one exchange, market type and quote currency	Its first signal	One strategy on many coins, with one key

Single-symbol bots

You choose the name, the exchange, the market type (Spot or Futures), the symbol, the allocated amount, and whether the bot trades on paper or live.

Every signal for the bot, exits included, must carry:

• the bot's symbol in ticker. Futures symbols end in .P, for example BTCUSDT.P. A signal for another symbol is rejected with Signal symbol does not match strategy symbol.
• the bot's exchange in exchange, for example BINANCE. Otherwise it is rejected with Exchange not found or does not match with strategy.

Auto bots

An auto bot is created empty, as "Auto Strategy (Waiting Signal)", on paper. Its first entry or VALIDATE_ALERT sets:

• the exchange, from exchange;
• the symbol, from ticker;
• the market type: Futures if the ticker ends in .P, otherwise Spot;
• the allocated amount: 100 in the quote currency, unless you set an amount before the first signal;
• the name, <EXCHANGE>-<TICKER> AUTO CREATED, unless you renamed the bot.

From then on it behaves exactly like a single-symbol bot. Exit signals that arrive before the first entry are skipped, because there is nothing to close. If two first signals for different symbols arrive at the same moment, the first one configures the bot and the other one is rejected by the symbol check.

Multi-symbol bots

A multi-symbol bot trades many coins with one key. Each coin it trades becomes a child bot with its own trades. The children share the bot's budget, which is split into equal slots. Multi-symbol bots need a Plus (up to 10 open coins) or Pro (up to 20 open coins) plan.

See Multi-symbol bots.

Paper and live

• Paper bots simulate fills on the real market data of the bot's exchange. They need no exchange connection.
  • Paper trades have no exchange-side stop-loss or take-profit: they open and close on your signals. Send a CLOSE when your stop or target is hit.
  • On the Free plan, paper trades have their own monthly limit.
• Live bots trade on your exchange account and need an active connection for the bot's market type. Switching a bot from paper to live runs the same connection check.

You cannot switch a single-symbol bot between paper and live while it has an open trade. For a multi-symbol bot, the switch is refused while any of its coins is open.

Verification

A new bot is unverified until its first valid entry, stop move or VALIDATE_ALERT arrives. That signal verifies it (and, if it is an entry, is executed), and you are notified. Being unverified only matters for a close sent before that: it has nothing to close and is not executed, unless a trade is open, in which case it still runs. A signal that is rejected (for example for the wrong symbol) does not change the verified state.

Allocation and PnL

The allocated amount is the budget an entry is sized from. The position's notional value is:

notional = allocated_amount * tradable_ratio * leverage

tradable_ratio defaults to the full allocation. On a live bot, the allocation is limited to the free balance of the account; if the balance is lower, the entry uses what is available and you get a warning.

When a trade closes, its PnL is added to the bot's allocated amount, so the bot compounds. The amount is capped at the account's balance. A multi-symbol bot's coins compound into the bot's shared budget.

Starting, stopping, editing and deleting

Action	What happens
Start	A live bot needs an active exchange connection. Your plan's limit on active bots applies (a multi-symbol bot counts as one).
Stop	Open positions are closed. Then the bot stops taking new entries.
Edit	A single-symbol bot cannot be edited while it has an open trade. For a multi-symbol bot, max_positions cannot be set below the number of coins that are currently open.
Delete	Refused while the bot has an open trade. Close it first. A multi-symbol bot is deleted together with all its coins.

When a bot's plan check fails (your subscription expired, or the Free plan's monthly trade limit was reached), new entries are rejected and the bot is stopped. Exits for open trades still go through.

Plans

	Free	Plus	Pro
Own webhook bots	Yes, with a monthly trade limit (live and paper counted separately)	Yes, no monthly trade limit	Yes, no monthly trade limit
Multi-symbol bots	No	Up to 10 open coins per bot	Up to 20 open coins per bot

The number of bots that can be active at the same time also depends on your plan, and the app shows your current limits.

Next steps

• Multi-symbol bots
• Partial close
• TradingView integration
• Signal flow: every check a signal passes, in order