Setting Up Your Webhook

Step 1: Get Your Webhook Token

  1. Log in to HyperSync

  2. Navigate to Signals from the sidebar

  3. Your unique Webhook Token is displayed on the page

  4. Copy it — you'll need it for the TradingView alert

Each user has a unique webhook token. This authenticates your signals so only you can trigger trades on your account.

Step 2: Get Your Webhook URL

Your webhook URL is provided on the Signals page in your HyperSync dashboard. It looks like:

https://your-hypersync-domain.com/api/v1/signals/webhook

Note: TradingView requires a publicly accessible HTTPS URL. This won't work with a local development server.

Step 3: Create a TradingView Alert

  1. Click the Alert button (bell icon) or press Alt + A

  2. Configure your alert condition:

    • Condition: Select your indicator or strategy

    • Trigger: Choose when to fire (e.g., "Crossing", "Greater than")

  3. In the Notifications section:

    • Enable Webhook URL

    • Paste your HyperSync webhook URL

  4. In the Message field, paste the JSON payload (see Alert Format)

  5. Click Create

Setting
Recommendation

Expiration

Open-ended (no expiration) for ongoing strategies

Alert actions

Webhook URL enabled

Trigger

"Once Per Bar Close" for most strategies

Step 4: Verify It Works

After creating your alert:

  1. Wait for the condition to trigger (or create a test alert with a condition that triggers immediately)

  2. Go to the Signals page in HyperSync

  3. You should see the signal in your signal history

  4. Check the status: Received, Executed, or Rejected

If the signal shows as Executed, your webhook is working correctly.

Tips

  • Use "Once Per Bar Close" to avoid multiple signals firing within the same candle

  • Start with testnet — Connect a testnet wallet first to verify everything works

  • Check the Signals page — It shows every signal received, whether it was executed, and why it was rejected if applicable

  • Double-check your token — The most common issue is a mismatched webhook token

Last updated