Skip to Content
SignalWise

Alert message

The structure of a SignalWise alert on Kafka.

The alert object

Each Kafka message is one alert, in five blocks:

BlockContent
eventMetadataID, type, date, sentiment and priority of the alert
eventContentReady-to-use title and text in each of your languages
alertEvidencesThe prices behind the alert
assetsDetailsThe asset
reasoningUp to 3 reasons (Advanced plan). Empty if there is none.

The schema registered in the Schema Registry for your topic is the source of truth. Your topic may include extra fields agreed with you, such as nativeAssetName, logoUrl or your own identifiers.

THE ALERT OBJECT
{
  "eventMetadata": {
    "uniqueEventId": "6f85f394-bae8-4ead-a18a-3e3cfbcffc59",
    "eventName": "Price drop",
    "eventType": "AggressiveMoveIdentificationAlertLow",
    "eventDate": "2026-11-12 15:40:05.989797 UTC",
    "eventSentiment": "Negative",
    "eventImportanceLevel": 2
  },
  "eventContent": {
    "emoji": "๐Ÿ“‰",
    "en-US": {
      "eventTitle": "Sharp Move Down",
      "eventBody": "Acme Corp is dropping 6.3% today.",
      "eventBodyShort": "Acme Corp down 6.3%"
    }
  },
  "alertEvidences": {
    "assetTriggerPrice": 93.7,
    "assetThresholdPrice": 95.0,
    "assetChangePercent": -6.3
  },
  "assetsDetails": {
    "assetId": "2590144",
    "companyId": "24893",
    "tradingItemId": "2590144",
    "tickerSymbol": "ACME",
    "tickerExchange": "NYSE",
    "assetName": "Acme Corporation",
    "assetNameShort": "Acme Corp",
    "assetType": "Stock",
    "currency": "USD",
    "domicile_country": "United States",
    "primary_exchange_country": "United States"
  },
  "reasoning": [
    {
      "category": "Earnings & Financials",
      "emoji": "๐Ÿ“Š",
      "relevancy_score": 1,
      "content": [
        {
          "language": "en_US",
          "title": "Quarterly revenue below estimates",
          "body": "Acme reported quarterly revenue of $2.1B, 4% below analyst consensus, and lowered its full-year outlook."
        }
      ]
    }
  ]
}

eventMetadata

Attributes

uniqueEventIdstringRequired
Unique ID of the alert (UUID). Use it to deduplicate and in support requests.
eventTypestringRequired
The alert type, for example PriceBreaks52WeekHighAlert. See Alert types.
eventNamestringRequired
Broad label: Price gain, Price drop or Technical event.
eventDatestringRequired
When the alert was created, in UTC, for example 2026-11-12 15:40:05.989797 UTC.
eventSentimentstringRequired
Positive or Negative.
eventImportanceLevelintegerRequired
Priority of the alert type: 1 (high) to 3 (low). For example, a 52-week high ranks above a 50-day high.
EVENT METADATA
{
  "uniqueEventId": "6f85f394-bae8-4ead-a18a-3e3cfbcffc59",
  "eventName": "Price drop",
  "eventType": "AggressiveMoveIdentificationAlertLow",
  "eventDate": "2026-11-12 15:40:05.989797 UTC",
  "eventSentiment": "Negative",
  "eventImportanceLevel": 2
}

eventContent

Ready-to-use texts, one object per language. Keys are locale codes with a hyphen, for example en-US, ja-JP.

Attributes

emojistring
An emoji matching the alert.
<locale>.eventTitlestringRequired
Short title, for example Sharp Move Down.
<locale>.eventBodystringRequired
The alert text.
<locale>.eventBodyShortstring
A shorter text, for example for push notification titles.
EVENT CONTENT
{
  "emoji": "๐Ÿ“‰",
  "en-US": {
    "eventTitle": "Sharp Move Down",
    "eventBody": "Acme Corp is dropping 6.3% today.",
    "eventBodyShort": "Acme Corp down 6.3%"
  },
  "ja-JP": {
    "eventTitle": "ๆ€ฅๆฟ€ใชไธ‹่ฝ",
    "eventBody": "Acme CorpใŒๆœฌๆ—ฅ6.3%ไธ‹่ฝใ—ใฆใ„ใพใ™ใ€‚",
    "eventBodyShort": "Acme Corp 6.3%ไธ‹่ฝ"
  }
}

alertEvidences

Attributes

assetTriggerPricenumberRequired
The price that fired the alert. 2 decimals for stocks and ETFs, 3 for other assets.
assetThresholdPricenumberRequired
The threshold level that was crossed.
assetChangePercentnumberRequired
The change in % against the previous close, at the time of the alert.

Prices quoted in British pence (GBp) are converted to pounds (GBP).

ALERT EVIDENCES
{
  "assetTriggerPrice": 93.7,
  "assetThresholdPrice": 95.0,
  "assetChangePercent": -6.3
}

assetsDetails

Attributes

assetIdstringRequired
Bridgewise asset ID.
companyIdstringRequired
Company ID (CID). -1 for crypto, forex and commodities.
tradingItemIdstringRequired
Listing ID (TID). -1 for crypto, forex and commodities.
tickerSymbolstringRequired
Ticker, for example AAPL or BTCUSD.
tickerExchangestringRequired
Exchange, for example NASDAQ or CRYPTO.
assetNamestringRequired
Full name. Can be long: avoid tight length limits.
assetNameShortstringRequired
Short name for display.
assetTypestringRequired
Stock, ETF, Cryptocurrency, Futuresโ€ฆ
currencystringRequired
Quote currency, ISO 4217.
domicile_countrystring
Country of the company. Global when not applicable.
primary_exchange_countrystring
Country of the main listing. Global when not applicable.
CRYPTO EXAMPLE
{
  "assetId": "-1",
  "companyId": "-1",
  "tradingItemId": "-1",
  "tickerSymbol": "BTCUSD",
  "tickerExchange": "CRYPTO",
  "assetName": "Bitcoin",
  "assetNameShort": "Bitcoin",
  "assetType": "Cryptocurrency",
  "currency": "USD",
  "domicile_country": "Global",
  "primary_exchange_country": "Global"
}

reasoning

An array of up to 3 reasons, ordered from the most to the least relevant. Empty when the alert has no reasoning.

Attributes

categorystringRequired
Earnings & Financials, Corporate Actions & Changes, Market News & Events or Macroeconomic Indicators & Policy.
emojistring
An emoji matching the reason.
relevancy_scoreinteger | null
1 (strongest link to the move) to 5. Scores 4 and 5 are filtered out by default.
contentarrayRequired
One entry per language.
content[].languagestringRequired
Locale with an underscore, for example en_US, ja_JP.
content[].titlestringRequired
Title of the reason.
content[].bodystringRequired
One or two sentences.

Two locale formats

eventContent keys use a hyphen (en-US), while reasoning[].content[].language uses an underscore (en_US).

REASONING
[
  {
    "category": "Earnings & Financials",
    "emoji": "๐Ÿ“Š",
    "relevancy_score": 1,
    "content": [
      {
        "language": "en_US",
        "title": "Quarterly revenue below estimates",
        "body": "Acme reported quarterly revenue of $2.1B, 4% below analyst consensus, and lowered its full-year outlook."
      },
      {
        "language": "ja_JP",
        "title": "ๅ››ๅŠๆœŸๅฃฒไธŠ้ซ˜ใŒไบˆๆƒณใ‚’ไธ‹ๅ›žใ‚‹",
        "body": "Acmeใฎๅ››ๅŠๆœŸๅฃฒไธŠ้ซ˜ใฏ21ๅ„„ใƒ‰ใƒซใงใ€ใ‚ขใƒŠใƒชใ‚นใƒˆไบˆๆƒณใ‚’4%ไธ‹ๅ›žใ‚Šใ€้€šๆœŸ่ฆ‹้€šใ—ใ‚’ๅผ•ใไธ‹ใ’ใพใ—ใŸใ€‚"
      }
    ]
  }
]

Legacy flat format

Some older topics (names starting with daily-insights-) use a flat format: all fields sit in eventAttributes, texts are named subject_<locale> and title_<locale>, and reasons are named reasoningOneTitleEn-US, reasoningTwoBodyEn-US, and so on. Empty reasons are empty strings.

New integrations should use the nested format above.

LEGACY FLAT FORMAT (EXCERPT)
{
  "uniqueEventId": "87ee3af3-fa52-472a-bad2-f87b9d8a9c2c",
  "eventType": "PriceBreaks50DaysLowAlert",
  "eventDate": "2026-06-25 19:40:10.460961 UTC",
  "eventAttributes": {
    "assetClass": "Stock",
    "listOfSymbols": ["ACME"],
    "triggerPrice": 46.24,
    "assetThresholdPrice": 46.27,
    "assetChangePercent": -2.3,
    "eventSentiment": "Negative",
    "eventImportanceLevel": 2,
    "title_en-US": "50-Day Low",
    "subject_en-US": "Acme Corp is hitting a new 50-Day Low at $46.24",
    "reasoningOneCategory": "Earnings & Financials",
    "reasoningOneTitleEn-US": "Revenue missed expectations",
    "reasoningOneBodyEn-US": "Acme reported revenue $15M below estimates.",
    "reasoningTwoCategory": "",
    "reasoningTwoTitleEn-US": "",
    "reasoningTwoBodyEn-US": ""
  }
}