Alert message
The structure of a SignalWise alert on Kafka.
The alert object
Each Kafka message is one alert, in five blocks:
| Block | Content |
|---|---|
eventMetadata | ID, type, date, sentiment and priority of the alert |
eventContent | Ready-to-use title and text in each of your languages |
alertEvidences | The prices behind the alert |
assetsDetails | The asset |
reasoning | Up 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.
{
"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
uniqueEventIdstringRequiredeventTypestringRequiredPriceBreaks52WeekHighAlert. See Alert types.eventNamestringRequiredPrice gain, Price drop or Technical event.eventDatestringRequired2026-11-12 15:40:05.989797 UTC.eventSentimentstringRequiredPositive or Negative.eventImportanceLevelintegerRequired1 (high) to 3 (low). For example, a 52-week high ranks above a 50-day high.{
"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<locale>.eventTitlestringRequiredSharp Move Down.<locale>.eventBodystringRequired<locale>.eventBodyShortstring{
"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
assetTriggerPricenumberRequiredassetThresholdPricenumberRequiredassetChangePercentnumberRequiredPrices quoted in British pence (GBp) are converted to pounds (GBP).
{
"assetTriggerPrice": 93.7,
"assetThresholdPrice": 95.0,
"assetChangePercent": -6.3
}assetsDetails
Attributes
assetIdstringRequiredcompanyIdstringRequired-1 for crypto, forex and commodities.tradingItemIdstringRequired-1 for crypto, forex and commodities.tickerSymbolstringRequiredAAPL or BTCUSD.tickerExchangestringRequiredNASDAQ or CRYPTO.assetNamestringRequiredassetNameShortstringRequiredassetTypestringRequiredStock, ETF, Cryptocurrency, FuturesโฆcurrencystringRequireddomicile_countrystringGlobal when not applicable.primary_exchange_countrystringGlobal when not applicable.{
"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
categorystringRequiredEarnings & Financials, Corporate Actions & Changes, Market News & Events or Macroeconomic Indicators & Policy.emojistringrelevancy_scoreinteger | nullcontentarrayRequiredcontent[].languagestringRequireden_US, ja_JP.content[].titlestringRequiredcontent[].bodystringRequiredTwo locale formats
eventContent keys use a hyphen (en-US), while reasoning[].content[].language uses an underscore (en_US).
[
{
"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.
{
"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": ""
}
}