Personalized alert message
One message per user who holds or watches the asset.
The personalized alert
With the Personalized plan, you receive on your dedicated topic one message per user who holds or watches the asset.
It contains the same blocks as the alert message, plus who the alert is for. Texts are provided in the user's PreferredLanguages only.
Recipient attributes
userIdstringRequiredYour user's ID, as you sent it.
accountIdstringRequiredThe user's account holding the asset.
collectionIdstringRequiredThe portfolio or watchlist holding the asset.
collectionTypeenumRequiredPortfolio or Watchlist.Other blocks
eventMetadataobjectRequiredAlert ID (
eventId), type, date, sentiment, priority. See eventMetadata.eventContentobjectRequiredTitle and text per language.
alertEvidencesobjectRequiredTrigger price, threshold price, change %.
assetsDetailsobjectRequiredThe asset, plus
isin and your own identifier when available.reasoningarrayUp to 3 reasons, if your plan includes reasoning.
PERSONALIZED ALERT
{
"userId": "user-42",
"accountId": "acc-7781",
"collectionId": "wl-1",
"collectionType": "Watchlist",
"eventMetadata": {
"eventId": "54b1e0c2-7d1f-4a4e-9b8e-0f6a1c2d3e4f",
"eventName": "Price gain",
"eventType": "PriceBreaks52WeekHighAlert",
"eventDate": "2026-11-12T15:40:05Z",
"eventSentiment": "Positive",
"eventImportanceLevel": 1
},
"eventContent": {
"en-US": {
"eventTitle": "52-Week High",
"eventBody": "Acme Corp reached a new 52-week high at $120.50."
},
"fr-FR": {
"eventTitle": "Plus haut sur 52 semaines",
"eventBody": "Acme Corp atteint un nouveau plus haut sur 52 semaines à 120,50 $."
}
},
"alertEvidences": {
"assetTriggerPrice": 120.5,
"assetThresholdPrice": 120.1,
"assetChangePercent": 2.4
},
"assetsDetails": {
"assetId": "2590144",
"tickerSymbol": "ACME",
"tickerExchange": "NYSE",
"isin": "US0000000001",
"assetName": "Acme Corporation",
"assetNameShort": "Acme Corp",
"assetType": "Stock",
"currency": "USD"
},
"reasoning": []
}Field lengths
| Field | Maximum length |
|---|---|
eventTitle, eventName, assetName | 255 characters |
eventBody | 1,000 characters |
assetNameShort | 100 characters |
tickerSymbol, tickerExchange | 10 characters |
Message key
Use userId + eventId to deduplicate on your side.
DEDUPLICATION KEY
key = f"{msg['userId']}::{msg['eventMetadata']['eventId']}"
if key in already_sent:
return
already_sent.add(key)
notify(msg)