Signal Payload Format

The signal payload is the core JSON structure that Towerflow uses to trigger trading actions through webhooks or webhook email addresses. When a signal is sent, it must match this format so the system can understand and execute it properly.

Below is the expected payload schema:

SignalPayload = {
  name?: string,                // A custom name for the alert (optional)
  key?: string,                 // Authorization key (required if webhook is key-protected)
  symbol: string,               // The trading pair (e.g., 'BTCUSDT', 'ETHUSDT')
  side: OrderSide,              // Either 'BUY | buy' or 'SELL | sell'
  size?: number,                // Trade size (in quote currency), overrides default (optional)
  stop?: number,                // Stop-loss price (optional)
  take?: number,                // Take-profit price (optional)
  dilution?: boolean,           // If true, allows partial stacking of positions (optional)
  public?: boolean,             // Whether the signal should be visible to others (default: true)
  flag?: FlagType | FlagType[], // Additional tags like 'TEST', 'DEBUG', 'REVERSE' (optional)
  debug?: any,                  // Extra debugging info (optional)
}

---

🔍 Field Descriptions

• name (optional): A custom label for the signal. Useful for identifying or grouping alerts in your dashboard.

• key (optional, required in safe mode): The security key required for webhooks that are key-protected. Must match the one set during webhook creation.

• symbol (required): The trading pair this signal targets. For example, BTCUSDT, ETHUSD, etc.

• side (required): The trade direction. Must be either:

  • 'BUY | buy' – to open or increase a long position

  • 'SELL | sell' – to close or open a short position

• size (optional): The trade amount (in quote currency). If not set, the default configured size for the connected bot will be used.

• stop (optional): A stop-loss value. This defines the maximum acceptable loss level.

• take (optional): A take-profit value. This defines the target price to close the position in profit.

• dilution (optional): If set to true, the bot will stack this trade on top of an existing position if it's in the same direction, instead of replacing it.

• public (optional): If set to false, the signal remains private to the owner. By default, signals are considered public if shared.

• flag (optional): Tags that describe the signal’s purpose or behavior, such as:

  • 'TEST' – test only, no real trade

  • 'DEBUG' – for debugging

  • 'REVERSE' – interpret as reverse trade You can use a single flag or multiple in an array.

• debug (optional): Any custom or diagnostic information. This data isn’t used by bots, but helps in testing or logging.

---

✅ Example Payloads

Simple

{
  "key": "secret123",
  "symbol": "BTCUSDT",
  "side": "BUY",
}

More complex

{
  "name": "Super Strategy",
  "key": "secret123",
  "symbol": "BTCUSDT",
  "side": "BUY",
  "size": 100,
  "stop": 29500,
  "take": 31000,
  "dilution": true,
  "public": true,
  "flag": ["TEST", "DEBUG"]
}