Skip to content
Algo Trade Analytics Docs

Quick Start Guide

📋 Prerequisites

Section titled “📋 Prerequisites”

Before you begin, make sure you have:

  • TradingView Account with Pine Script access
  • Alpaca Trading Account (paper or live)
  • Basic understanding of trading concepts

🚀 Step 1: Set Up Your Alpaca Account

Section titled “🚀 Step 1: Set Up Your Alpaca Account”

Get Your API Keys

Section titled “Get Your API Keys”
  1. Log into your Alpaca Dashboard
  2. Navigate to “Your API Keys” section
  3. Generate new API keys:
    • API Key ID (public)
    • Secret Key (private)
  4. Important: Start with paper trading keys for testing

Configure API Keys in Algo Trade Analytics

Section titled “Configure API Keys in Algo Trade Analytics”
  1. Go to Settings → API Keys in Algo Trade Analytics
  2. Enter your Alpaca credentials: 
    API Key ID: [Your Alpaca Key ID]
    Secret Key: [Your Secret Key]
    Environment: Paper (for testing)
  3. Click “Test Connection” to verify

🔗 Step 2: Create Your First Webhook

Section titled “🔗 Step 2: Create Your First Webhook”

Generate Webhook URL

Section titled “Generate Webhook URL”
  1. Navigate to Webhooks → Create New
  2. Fill in webhook details:
    • Name: “My First Strategy”
    • Description: “Testing Algo Trade Analytics integration”
    • Auth Key: Auto-generated secure key
  3. Copy the generated webhook URL

Webhook URL Format

Section titled “Webhook URL Format”
https://your-algo-trade-analytics-domain.com/api/webhook/[YOUR_WEBHOOK_ID]

📝 Step 3: Create Your Pine Script Strategy

Section titled “📝 Step 3: Create Your Pine Script Strategy”

Basic Strategy Template

Section titled “Basic Strategy Template”

Copy this Pine Script template to TradingView:

//@version=6
strategy("Algo Trade Analytics Quick Start", overlay=true)


// Algo Trade Analytics Configuration
authKey = "your_auth_key_here"  // Replace with your auth key
ticker = syminfo.ticker


// Simple Moving Average Strategy
maLength = input.int(20, "MA Length")
ma = ta.sma(close, maLength)


// Entry Conditions
longCondition = ta.crossover(close, ma)
shortCondition = ta.crossunder(close, ma)


// Webhook Messages (Algo Trade Analytics format)
longMessage = '{"ticker":"' + ticker + '","direction":"long","auth_key":"' + authKey + '","qty":10}'
shortMessage = '{"ticker":"' + ticker + '","direction":"short","auth_key":"' + authKey + '","qty":10}'


// Execute Trades
if longCondition
    strategy.entry("Long", strategy.long, alert_message=longMessage)
if shortCondition
    strategy.entry("Short", strategy.short, alert_message=shortMessage)


// Plot Moving Average
plot(ma, "MA", color=color.blue)

Configure the Script

Section titled “Configure the Script”
  1. Replace your_auth_key_here with your actual auth key from Step 2
  2. Adjust quantity (qty:10) based on your risk tolerance
  3. Save the script in TradingView

🔔 Step 4: Set Up TradingView Alerts

Section titled “🔔 Step 4: Set Up TradingView Alerts”

Create Alert

Section titled “Create Alert”
  1. Right-click on your chart in TradingView
  2. Select “Add Alert”
  3. Configure alert settings:
    • Condition: Choose your strategy
    • Options: “Once Per Bar Close”
    • Expiration: Never
    • Actions: Check “Webhook URL”

Add Webhook URL

Section titled “Add Webhook URL”
  1. In the Webhook URL field, paste your Algo Trade Analytics webhook URL
  2. Message: Leave empty (Pine Script handles this)
  3. Click “Create”

✅ Step 5: Test Your Setup

Section titled “✅ Step 5: Test Your Setup”

Send Test Trade

Section titled “Send Test Trade”
  1. Go to Algo Trade Analytics → Webhooks → Test
  2. Select your webhook
  3. Send a test message: 
    {
      "ticker": "AAPL",
      "direction": "long",
      "auth_key": "your_auth_key",
      "qty": 1
    }

Verify in Alpaca

Section titled “Verify in Alpaca”
  1. Check your Alpaca Dashboard
  2. Look for the test order in Orders section
  3. Verify it was executed correctly

📊 Step 6: Monitor Your Trades

Section titled “📊 Step 6: Monitor Your Trades”

Algo Trade Analytics Dashboard

Section titled “Algo Trade Analytics Dashboard”
  1. Navigate to Dashboard → Trade Analysis
  2. View real-time trade matching
  3. Monitor performance metrics:
    • Win Rate
    • Profit Factor
    • Average Slippage

Key Metrics to Watch

Section titled “Key Metrics to Watch”
  • Setup Cost: Intentional strategy cost
  • Execution Slippage: Unintended deviation
  • Fill Rate: Percentage of successful orders
  • Latency: Time from signal to execution

🛡️ Step 7: Risk Management

Section titled “🛡️ Step 7: Risk Management”

Essential Settings

Section titled “Essential Settings”
  1. Position Sizing: Never risk more than 1-2% per trade
  2. Stop Losses: Always use protective stops
  3. Daily Limits: Set maximum daily loss limits
  4. Paper Trading: Test thoroughly before going live

Risk Management Code

Section titled “Risk Management Code”

Add this to your Pine Script for better risk control:

// Risk Management
riskPercent = input.float(1.0, "Risk % per trade")
accountBalance = 10000  // Your account size
stopLossPercent = input.float(2.0, "Stop Loss %")


// Calculate position size
riskAmount = accountBalance * (riskPercent / 100)
stopDistance = close * (stopLossPercent / 100)
qty = math.round(riskAmount / stopDistance)


// Use calculated quantity in webhook
longMessage = '{"ticker":"' + ticker + '","direction":"long","auth_key":"' + authKey + '","qty":' + str.tostring(qty) + '}'

🎯 Next Steps

Section titled “🎯 Next Steps”
Section titled “Recommended Actions”
  1. Start Small: Begin with minimal position sizes
  2. Monitor Closely: Watch first few trades carefully
  3. Analyze Performance: Use Algo Trade Analytics analytics
  4. Optimize Strategy: Refine based on results

Advanced Features

Section titled “Advanced Features”
  • Multiple Timeframes: Scale your strategy
  • Complex Order Types: Stop-limit orders
  • Portfolio Management: Multiple strategies
  • Risk Analytics: Advanced performance metrics

📚 Additional Resources

Section titled “📚 Additional Resources”

⚠️ Important Notes

Section titled “⚠️ Important Notes”

Congratulations! 🎉 You’ve successfully set up Algo Trade Analytics. Your TradingView strategies can now automatically execute trades through Alpaca with full analytics and monitoring.