Nyria Docs
IntegrationsThird-Party Services

Discord Integration

Automate alerts from Discord servers you manage.

Connect Discord to automate trading alerts from servers where you have administrator permissions.

Overview

Discord integration allows you to:

  • Monitor specific channels for trading alerts
  • Filter alerts by author or keyword
  • Use natural language alerts
  • Automate signals from trading communities you manage

Requirements

  • Discord account linked to Nyria
  • Administrator permissions in the Discord server
  • Nyria bot invited to your server

Setup Process

  1. Navigate to Integrations tab
  2. Click Connect Discord
  3. Authorize Nyria to access your Discord account
  4. Grant required permissions

2. Invite Nyria Bot

  1. Go to your Discord server
  2. Use the invite link provided in Nyria
  3. Grant bot permissions:
    • Read Messages
    • Read Message History
    • View Channels

3. Create Discord Strategy

When creating a strategy with Discord as the alert source:

  1. Select Server - Choose from servers where you're an admin
  2. Select Channel - Pick the channel containing alerts
  3. Author Filter (optional) - Monitor specific user only
  4. Keyword Filter (optional) - Match messages containing text

Alert Format

Discord alerts use natural language parsing:

Simple Alerts

spy long entry
close short btc
aapl short

Detailed Alerts

SPY 675C buy to open
BTC long entry at 50000
close spy 675C/676C spread

Options with External Selection

For strategies using external selection, specify strikes:

SPY 675C/676C bull call spread
buy SPY 675 put

Discord alerts are flexible. Use natural language that clearly indicates instrument, direction, and action.

Configuration Options

Author Filter

Monitor alerts from a specific user:

  • Enter their Discord username or ID
  • Only messages from this user trigger trades
  • Useful for single-source alert channels

Keyword Filter

Filter messages containing specific text:

  • Alerts must include the keyword
  • Case-insensitive matching
  • Useful for multi-purpose channels

Example Configurations

Dedicated Alerts Channel:

  • Channel: #alerts
  • Author: (none)
  • Keyword: (none)
  • Result: All messages in #alerts trigger parsing

Filtered by Author:

  • Channel: #trading
  • Author: SignalBot#1234
  • Keyword: (none)
  • Result: Only SignalBot's messages trigger parsing

Keyword Filtered:

  • Channel: #general
  • Author: (none)
  • Keyword: ALERT
  • Result: Only messages containing "ALERT" trigger parsing

Alert Validation

When validating Discord strategies:

  1. Select actual messages from your channel
  2. Map each message to an alert type (long entry, long exit, etc.)
  3. System validates parsing and execution
  4. Strategy activates once validation passes

Best Practices

Channel Organization

  • Use dedicated alerts channel
  • Keep alerts concise
  • Maintain consistent format
  • Avoid mixing alerts with discussion

Alert Clarity

Good alerts:

  • ✅ "SPY long entry"
  • ✅ "close short BTC"
  • ✅ "AAPL 150C buy"

Unclear alerts:

  • ❌ "thinking about SPY"
  • ❌ "maybe close later"
  • ❌ "spy???"

Exit Matching

For exits to match entries:

  • Use same instrument name
  • Specify direction being closed
  • System automatically finds open positions

Permissions

Required Bot Permissions

  • View Channels - See channel list
  • Read Messages - Access message content
  • Read Message History - Process historical messages during validation

Your Permissions

  • Manage Server - Required to configure strategies
  • Server administrator or owner

Limitations

  • Only servers where you're an admin
  • Text channels only (no voice/forum channels)
  • Messages must be parseable as alerts
  • Rate limited to prevent spam

Troubleshooting

"Server not found"

Ensure:

  • You're an administrator in the server
  • Nyria bot is invited to the server
  • Server is not deleted or unavailable

"Channel not accessible"

Check:

  • Channel still exists
  • Nyria bot has access to the channel
  • Channel is a text channel

"Could not parse alert"

Discord message doesn't contain clear trading intent:

  • Include instrument name
  • Specify direction (long/short)
  • Indicate action (entry/exit/open/close)

"Multiple entries disabled"

Strategy doesn't allow multiple simultaneous positions. Wait for current position to close before new entry.

Security

  • Only you can configure strategies from your servers
  • Bot only reads messages (cannot send or delete)
  • Webhook URLs are unique and private
  • Revoke access anytime from Discord settings

Next Steps