Bots

A bot runs one strategy on one broker account with its own budget, instruments and overrides. How to deploy, size, monitor, and stop or pause one.

Bots are your personal trading automation instances. Each bot copies a strategy's signals and executes them through your chosen broker integration with your specified budget and instrument selection.

Before deploying a bot: Understand that bots execute trades automatically based on incoming alerts. You are responsible for monitoring your bot's activity, ensuring adequate capital, and intervening when issues occur. Read our Known Limitations before going live.

What is a Bot?

A bot is your configured instance of a strategy that:

Executes trades through your selected broker integration
Uses your specified budget for position sizing
Trades only your selected instruments
Applies your own overrides: forced market orders, and simulated leverage on a perpetuals strategy

Bots are not counted and not charged for. Deploy as many as you like; what your plan caps is the total allocation they can commit at once. Nyria Paper bots are the one exception: your plan sets how many you may hold, and the free tier allows 10.

You can deploy one bot per strategy per broker account. To run the same strategy twice, point the second bot at a different account. See Pricing & Limits.

Creating a Bot

The strategy must be Active first. A newly created strategy is a draft until its alert formats are validated on the Integration tab. Deploying a bot on a draft is refused with Bots can only be deployed to active strategies. See Alert Validation.

The deploy wizard has four steps: Size, Instruments, Account, Review. A strategy that allows a single instrument leaves nothing to pick, so its wizard skips Instruments and runs three steps.

Step 1: Size

Decide how much capital each signal may spend. There are two sizing modes, chosen from the How this bot sizes each signal dropdown:

Position Size

The dropdown option A dollar budget, entered in Budget per signal ($). This is the default mode and is available on every strategy.

Each entry will attempt to use this exact amount
This amount applies per ticker in the alert. A $500 position size on an alert with 2 tickers can deploy up to $1,000
If insufficient funds, the trade is skipped (not downsized)
Consistent position sizing regardless of account balance

Quantity

The dropdown option An exact number of shares (or contracts, or coins, depending on the strategy). Every signal enters that same number. For spreads, 2 enters 2 complete spread units.

Only available when the strategy's creator has set a max cost per unit. If they have not, the dropdown does not appear, and a deploy attempt is refused with The creator has not set a max cost per contract, so Nyria cannot price an exact contract count against your allocation. Size in dollars instead.
Must be a whole number, except on crypto, where coins trade in fractions
Your allocation is still counted in dollars. Each unit counts as the higher of the creator's declared cost per unit and the priciest entry the strategy has actually recorded, and the form shows both that per-unit figure and the resulting budget
The count is capped so the resulting budget stays inside your allocation. Over it, the form says Your allocation allows at most <n> contracts on this strategy. Each contract counts as $X of your allocation. See Allocation

If your dollar position size is too small to cover a single contract at current prices, the deploy is rejected up front rather than accepted and then skipping every signal.

Ensure you maintain sufficient buying power for both entries AND exits. Credit spread exits require debit orders, which need available capital.

Step 2: Instruments

Choose which of the strategy's instruments this bot may trade. Select All takes every one of them; you can then click individual instruments to drop them, and they appear under Excluded Instruments. Deselect All switches to picking specific instruments by hand.

For crypto strategies, you'll see instruments grouped by pairing (USDT or USDC).

A strategy that allows a single instrument does not get this step at all. The bot starts with that instrument selected, Account becomes step 2, and Review step 3. The Review screen still names the instrument.

Step 3: Account

Choose which integration to use for this bot:

Must support the strategy's equity type
Shows account type (Paper or Live)
Displays connection status

If you don't have a compatible integration, you can add one directly from this step.

Step 4: Review

Two cards summarise what you just set:

Position size - what this bot uses on each signal, and whether order types come from the strategy or are forced to market
Broker account - where this bot places its orders

Below them, a map of the strategy shows the instruments and the entry and exit rules the bot will follow.

Click Deploy Bot to activate.

Bot Settings

Always use market orders

If the strategy uses limit orders, this toggle overrides them:

On - every entry and exit is sent as a market order
Off - order types are set by the strategy

The toggle only appears on strategies that use limit orders somewhere.

Multiple Entries

Pyramiding is set on the strategy, not on the bot. If its author enabled Allow Multiple Entries, your bot can hold more than one position at a time, each sized by your own budget. If they did not, it holds one at a time (entry → exit → entry) and a second entry signal is logged as multiple entries disabled: open <side> position already exists.

Bot Management

Starting and Stopping

Active - Bot acts on the strategy's signals
Paused - Bot acts on nothing

A paused bot ignores exit signals too. Pausing closes nothing and does not hold a position safely: the next close signal passes the bot by and the position stays open. If anything is open, read Close a Position before you pause.

Editing Bots

Open the bot from My Bots and click Settings. It reopens the same four steps as the deploy wizard. You can change:

Position size and sizing mode
Selected instruments
Broker account
Always use market orders

Changing the broker integration will NOT transfer open positions. Close all positions before switching integrations.

Deleting Bots

Open the bot from My Bots and click Delete. What happens next depends on whether the bot has anything still open.

Nothing open or pending: the bot is removed and disappears from My Bots.

Something open or pending: the bot is not removed. It moves to a state called Closing Only and stays in your list with a blue Closing Only badge:

It stops acting on signals altogether, including close signals
It cannot be edited or started (This bot is pending deletion and can no longer be edited)
Deleting closes nothing for you

A Closing Only bot will not close its own position, so waiting does not clear it. Either restore the bot and close through Nyria, or close the position at your broker.

There are two ways forward:

Restore brings the bot back paused and cancels the pending deletion. No order is placed, cancelled or changed at your broker, and open positions stay exactly as they are. Start it when you want it acting on signals again.
Close the position at your broker, then delete the bot again. With nothing open, it is removed for good.

Restore is refused while the strategy behind the bot is unavailable: deleted, archived, back in draft, itself pending deletion, or a paid strategy your access to has lapsed. The dialog names which one.

A Closing Only bot still holds its strategy-and-account slot. Deploying a fresh bot on the same strategy and the same broker account fails while it sits there. Restore it instead, or clear it first and then redeploy.

Bot Logs

Each bot maintains execution logs showing:

SUCCESS - Trade executed successfully with order ID
WARN - Informational messages (e.g., no position to close)
ERROR - Execution failures with error details

Logs include metadata like:

Broker request details
Order IDs
Quantities and prices
Error messages

Failed alerts are logged with detailed error messages in Strategy or Bot Logs, depending on the cause of the failure. Check logs for specifics and ensure your alerts and settings adhere to broker and market capabilities.

Bot Performance

View your bot's performance metrics:

Total P&L - Realized profit/loss from closed positions
Trade Count - Number of completed trades
Win Rate - Percentage of profitable trades
Active Positions - Currently open positions

Troubleshooting

Bot Not Executing

Check:

Bot is Active (not paused)
Integration status is Connected (not reauth required)
Strategy is Active (validated and not paused)
Alert instrument matches your selected instruments
Sufficient buying power in broker account

Partial Fills

For spread orders, if some legs fill but others don't:

Remaining legs will be exited on next exit signal
Partial positions are tracked separately
Check broker account for any manual intervention needed

Order Rejections

Common causes:

Insufficient buying power
Invalid option strike (not available)
Broker-specific restrictions (PDT, margin requirements)
Market hours restrictions

Check bot logs for specific broker error messages. Nyria does not retry a rejected order, bar one cash-account close. When an Order Fails covers what to do, and why a rejected exit needs your attention immediately.