Bots

A bot places a strategy's trades in one of your broker accounts, at your budget per entry. You pick which of the strategy's tickers it trades. Everything else comes from the strategy, apart from one override: Force market orders sends every order at market.

You can deploy one bot per strategy per broker account. A live bot also needs room in your total entry allocation, which your plan sets.

Creating a bot

You can deploy only on an Active strategy, one whose alert format has been checked.

The deploy wizard has four steps: Size, Tickers, Account and Review. It skips Tickers when the strategy allows one ticker, and Account when Nyria Paper is your only account and Paper is on.

Step 1: Size

Choose how the bot sizes each entry in the Size by dropdown.

Dollar budget

Budget per entry is the default and works on every strategy.

Each entry spends up to this amount, whatever the account balance. The budget applies per ticker in the alert, so with $500 and an alert that names two tickers, the bot can spend up to $1,000. If the account can't cover an entry, the bot skips it rather than buying less.

On an options strategy, Nyria checks the budget against a live quote when you deploy, and refuses the deploy if the budget can't buy one contract. Without a quote, the deploy goes ahead.

Number of shares

Every entry opens that number of shares, contracts or coins, depending on the strategy. For spreads, 2 enters 2 whole spreads.

• Always offered on a paper bot, which draws on none of your total entry allocation
• On a live bot, offered when the strategy's creator has set a max cost per unit. Otherwise the dropdown does not show, and a live deploy is refused with Size live bots in dollars. The creator hasn't set a max cost per contract.
• Has to be a whole number, except on crypto, where coins trade in fractions
• Your total entry allocation is still counted in dollars. Each unit counts as the higher of the creator's stated cost per unit and the priciest entry the strategy has recorded, and the form shows that per-unit figure and the resulting budget
• The count is capped so the resulting budget stays inside your total entry allocation. Over it, the form says Your total entry allocation allows at most <n> contracts. See total entry allocation

Step 2: Tickers

Select the strategy's tickers this bot trades. With Select all, new tickers the strategy adds are included too.

Crypto strategies group tickers by pairing (USDT or USDC).

Step 3: Account

Choose the broker account this bot trades. The list shows only accounts that can trade the strategy's asset type, each with its account type (Paper or Live) and connection status. If none fits, add one from this step. The Live / Paper switch above the list sets which accounts you can pick.

Step 4: Review

Check the summary, then select the button that names your account, like Deploy on Nyria Paper. The bot is Active at once.

Sample alert

A new Nyria Paper bot's page has a Sample alert card. Select Send to run one test alert through the bot and watch it go from Sent to Filled. The trade is marked Sample and left out of P&L and win rate. On your own strategy, the card appears when every bot on it is yours and on Nyria Paper. On a spot crypto strategy that someone else runs, such as the example behind Run a free paper bot, the sample buys and sells once on your bot only, a few seconds apart, and never reaches the strategy or anyone else's bot. On an options strategy the sample needs the options market open. While it's closed, the card shows Rejected: Options market is closed.

Bot settings

Force 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

It appears only on strategies that use limit orders.

Multiple entries

Allow multiple entries is a strategy setting. When it's on, your bot can hold more than one position at a time, each sized by your own budget. When it's off, the bot holds one at a time and logs a second entry alert as a <side> <SYM> position is already open and Allow multiple entries is off.

Bot management

Starting and stopping

• Active: the bot acts on the strategy's alerts
• Paused: the bot acts on nothing

Editing bots

Open the bot from My bots and select Edit. The same four steps as the deploy wizard open again, and you can change:

• Budget per entry and sizing mode
• Selected tickers
• Account
• Force market orders

Deleting bots

Open the bot from My bots and select Delete. The result depends on whether the bot still has a position or an order 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 Closing only and stays in your list with a blue Closing only badge:

• It still acts on exit alerts, so the strategy's next exit closes what it holds, as long as its broker is Connected
• It places no new entries, and logs each entry alert it gets as skipped
• It can't be edited or started (This bot is closing only and can't be edited.)
• Deleting closes nothing by itself. The position closes on the strategy's next exit, even when the strategy itself is closing only. To stop waiting, close it at your broker. See closing a position

From there you can:

• Restore the bot. It comes back paused and leaves Closing only. Nothing is placed, canceled or changed at your broker, and open positions stay as they are. Start it when you want it acting on alerts 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 closing only, or a paid strategy you no longer have access to. The dialog says which.

Bot logs

Each row in a bot's Logs tab is one sentence about what happened, with a badge that tells you whether anything is left for you to do:

• Placed: the broker, or Nyria Paper, accepted the order. Placed isn't filled
• Logged: anything else that happened
• Skipped: nothing to trade and nothing for you to do, such as an exit with no position to close
• Needs attention: something is left for you, such as a position whose exit failed
• Failed: the order failed, with the reason

Details on a row opens the order, the Broker request and Broker response, and the Raw JSON.

Bot performance

Each bot shows:

• Realized P&L: profit or loss from closed positions
• Win rate: the share of profitable trades, with the wins and losses counted underneath
• Profit factor: dollars won per dollar lost. Above 1 is profitable
• Best trade: the largest profit on one closed trade

Troubleshooting

• The bot didn't place an order: see check these first
• Partial fills: the filled legs are tracked and exit on the next exit alert. See known limitations
• The broker rejected the order: the bot log has the broker's reason, and Nyria doesn't retry. See when an order fails

Next steps

• Closing a position
• What you can trade
• Strategy logs
• Notifications
• When an order fails
• Pricing and limits
• Integrations