Skip to content
Nyria Docs

Quick Start

Connect a broker, create a strategy, deploy a bot, then send your first alert. The short path from a new account to a working automation.

Set up your first automated trading strategy from scratch.

Before you begin: Automated trading carries significant risks. Read our Risk Disclosure and Known Limitations before proceeding. Always start with paper trading.

Prerequisites

Before starting, you'll need:

  • A Nyria account (Sign up here)
  • An alert source (TradingView, Discord, TrendSpider, or your own webhook)

You do not need a brokerage account to start. Nyria Paper, the built-in simulated broker, connects in one click and is free on every plan.

Important Considerations

  • Paper trade first - Test for at least 1-2 weeks before going live (what paper does and does not prove)
  • Verify your alerts - If using TradingView, ensure your strategy doesn't repaint (learn more)
  • Understand delays - TradingView webhooks can be delayed 2-45+ seconds
  • Monitor actively - Automated trading is not "set and forget"

Step 1: Connect a Broker (1 minute)

The fastest route is Nyria Paper. No account, no keys, no redirect:

  1. Click Integrations in the left sidebar
  2. Click the Nyria Paper card in the Brokers grid
  3. Click Create Nyria Paper account

✅ Your broker is now connected. It never expires and never needs reauthorizing.

Want to test against a real broker's own sandbox instead? Alpaca and Tradier both offer paper accounts; Schwab and tastytrade are live-only. See Paper Trading for the comparison.

Nyria Paper details → · Detailed integration guide →

Step 2: Create Your Strategy (10 minutes)

Basic Configuration

  1. Go to My Strategies
  2. Click Create strategy
  3. Fill in details:
    • Strategy Name: "My SPY Strategy"
    • Public URL: "my-spy-strategy"
    • Signal Source: TradingView
  4. Click Next

Configure Trading

  1. Asset Type: Options
  2. Selection Method: Internal (Configure legs)
  3. Long Behavior:
    • On a long entry signal: Enter Position
    • Enable exit orders: on
    • Order Type: Market
  4. Short Behavior:
    • On a short entry signal: Do Nothing

Add Option Legs (For Options)

Leg 1:

  • Action: Buy
  • Type: Call
  • Target Method: Delta, Delta Value 0.30
  • DTE: 7-31 days

Click Next to continue.

Set Visibility

  1. Choose Private
  2. Click Next

Instruments

  1. Search for "SPY"
  2. Click to add
  3. Click Next

Review

  1. Check the summary
  2. Click Create Strategy

✅ Your strategy is created, as a draft. Validating alerts is what activates it, and a draft cannot run a bot, so do Step 3 before Step 4.

Detailed strategy guide →

Step 3: Validate Alerts (5 minutes)

Creating the strategy drops you on its Integration tab. Because the signal source is TradingView, that tab runs a guided wizard: SetupCreate alertValidateDone.

  1. In Create alert, copy the webhook URL and the alert message into your TradingView alert (see the setup notes below)
  2. In Validate, paste that same alert message back and validate it
  3. Once it passes, the strategy status flips from Draft to Active

For Discord and Custom strategies the tab shows an Alert Validation card instead: type one example alert per enabled trade type, then click Validate Alert Formats.

TradingView Setup

Critical: Ensure your TradingView strategy does not "repaint" before automating. Repainting strategies show different signals historically than they fire in real-time. Learn about repainting

  1. In TradingView, open your chart with your strategy/indicator
  2. Click the Alert button (clock icon) or press Alt+A
  3. Configure the alert:
    • Condition: Your strategy or indicator
    • Options: "Once Per Bar Close" (fires once, on the confirmed close)
    • Webhook URL: Paste your Nyria webhook URL
    • Message: Your alert format, e.g., long entry {{ticker}}
  4. Click Create

Example Alert Messages:

long entry {{ticker}}
{
  "ticker": "{{ticker}}",
  "action": "{{strategy.order.action}}",
  "marketPosition": "{{strategy.market_position}}",
  "prevMarketPosition": "{{strategy.prev_market_position}}"
}

TradingView Variables:

VariableReplaced With
{{ticker}}Symbol (SPY, AAPL, etc.)
{{close}}Current close price
{{strategy.order.action}}buy or sell
{{strategy.market_position}}long, short, or flat

Discord Setup

  1. Invite Nyria bot to your server
  2. In Nyria, select your server and channel
  3. Send test message in Discord: "spy long entry"
  4. Use that message for validation

✅ Your strategy is now active.

Detailed validation guide →

Step 4: Deploy Your Bot (3 minutes)

  1. From your strategy, click Deploy a bot
  2. This strategy allows one ticker, so the wizard has no Instruments step. Work through the three steps:
    • Size: A dollar budget, Budget per signal ($) 500
    • Account: pick your connected broker account
  3. On Review, check the summary
  4. Click Deploy Bot

✅ Your bot is live. It will execute on the next matching alert.

Detailed bot guide →

Step 5: Test Your Setup

Send a Test Alert

TradingView:

  • Trigger your alert manually
  • Check Nyria strategy logs

Discord:

  • Send "spy long entry" in your channel
  • Check Nyria strategy logs

Custom:

  • Send POST request to webhook URL
  • Check Nyria strategy logs

Verify Execution

  1. On the strategy, open the Logs tab
  2. Look for the SUCCESS message
  3. Open the bot's Logs tab for execution details
  4. Verify the order in your broker account

What's Next?

Expand Your Automation

Go Live

The free tier is paper-only, so live trading needs either a Nyria Pro subscription or access to a paywalled strategy whose creator covers your allocation. Every Nyria Pro subscription starts with a 14-day free trial. You are not charged until it ends, and cancelling inside the trial costs nothing. See Pricing & Limits for every price and cap.

When you're ready to trade with real money:

  1. Connect a Live integration
  2. Create or edit a bot
  3. Select your live integration
  4. Start with small position sizes
  5. Monitor closely for the first few trades

Before going live, ensure you have:

  • Paper traded successfully for at least 1-2 weeks
  • Verified your TradingView strategy doesn't repaint
  • Sufficient capital for both entries AND exits
  • A plan for monitoring positions daily
  • Read and understood all Known Limitations

What to Monitor

Once live, you must actively monitor:

  • Daily: Check open positions match expectations
  • Daily: Review bot logs for any errors or warnings
  • Weekly: Verify broker connection status
  • Ongoing: Watch for reauth notifications (OAuth tokens expire)

Automated trading is NOT "set and forget." Things can and will go wrong. You are responsible for monitoring your positions and intervening when needed.

Common First-Time Issues

"Bot not executing"

  • Check bot is Active (not paused)
  • Verify integration is Connected
  • Ensure strategy is Active
  • Confirm alert instrument matches bot's selected instruments

"Order rejected"

  • Check buying power in broker account
  • Verify account has required permissions (options, margin, etc.)
  • Ensure position size isn't too large

Nyria does not retry a rejected order, bar one cash-account close. Read When an Order Fails for what to do about it.

"Could not parse alert"

  • Review alert validation examples
  • Ensure alert includes instrument, direction, and action
  • Check alert format matches what you validated

Full troubleshooting guide →

Getting Help

  • Documentation - Browse all guides
  • Discord - Join our community
  • Support - Email support@nyria.io

Next Steps