Create risk alert

Set up automated alerts for specific risk conditions

POST /risk/alerts

Create risk alert

cURL

curl --request POST \
  --url https://api.solarsentra.io/v1/risk/alerts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "walletId": "wlt_abc123def456",
  "condition": "risk_score_increase",
  "threshold": 50,
  "notificationMethod": "webhook",
  "webhookUrl": "https://yourapp.com/webhooks/risk-alerts"
}
'

201

{
  "alertId": "alert_abc123",
  "walletId": "wlt_abc123def456",
  "condition": "risk_score_increase",
  "status": "active",
  "createdAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

JWT Bearer token authentication. Include the token in the Authorization header

Body

application/json

walletId · string

Example:

"wlt_abc123def456"

condition · enum<string>

Available options: risk_score_increase, unusual_activity, large_transfer, suspicious_counterparty

Example:

"risk_score_increase"

threshold · number

Example:

50

notificationMethod · enum<string>

Available options: email, webhook, sms

Example:

"webhook"

webhookUrl · string

Example:

"https://yourapp.com/webhooks/risk-alerts"

Response

201 - application/json

Risk alert created successfully

alertId · string

Example:

"alert_abc123"

walletId · string

Example:

"wlt_abc123def456"

condition · string

Example:

"risk_score_increase"

status · string

Example:

"active"

createdAt · string<date-time>