Nyria Docs

Quick Start Guide

Get up and running with Nyria in minutes.

This guide will walk you through setting 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)
  • A broker account (we recommend starting with paper trading)
  • An alert source (TradingView, Discord, or custom)

Important Considerations

  • Paper trade first - Test for at least 1-2 weeks before going live
  • 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 Your Broker (5 minutes)

  1. Go to Integrations tab
  2. Click Add Integration
  3. Select your broker (e.g., Tradier for stocks/options)
  4. Choose Paper Trading for testing
  5. Complete OAuth authorization

✅ Your broker is now connected and ready to use!

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:
    • Name: "My SPY Strategy"
    • Public URL: "my-spy-strategy"
    • Alert Source: TradingView
    • Visibility: Private

Configure Trading

  1. Asset Type: Options
  2. Selection Type: Internal
  3. Long Behavior:
    • Entry: Enter Direction
    • Exit: Enabled
    • Order Type: Market
  4. Short Behavior:
    • Entry: Do Nothing
    • Exit: Disabled

Add Option Legs (For Options)

Leg 1:

  • Action: Buy
  • Side: Call
  • Target: Delta 0.30
  • DTE: 7-45 days

Click Next to continue.

Select Instruments

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

Set Visibility

  1. Choose Private
  2. Click Create Strategy

✅ Your strategy is created! Now let's validate alerts.

Detailed strategy guide →

Step 3: Validate Alerts (5 minutes)

  1. Go to your strategy's Integration tab
  2. Copy your webhook URL
  3. Set up your alert source (see below)
  4. Return to Nyria and click Validate Alerts
  5. Provide example alerts:
    • Long Entry: "spy long entry"
    • Long Exit: "spy long exit"
  6. Click Validate

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" (recommended to avoid repainting)
    • 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}}",
  "sentiment": "{{strategy.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 and ready to use!

Detailed validation guide →

Step 4: Deploy Your Bot (3 minutes)

  1. From your strategy, click Deploy Bot
  2. Configure bot:
    • Position Size: $500 (fixed)
    • Instruments: Trade All
    • Integration: Select your connected broker
  3. Review settings
  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. Go to Strategy Logs tab
  2. Look for SUCCESS message
  3. Check Bot Logs for execution details
  4. Verify order in your broker account

What's Next?

Expand Your Automation

Go Live

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

"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