# Alerts

Analytical alerts about staking pool and network metric changes

## List staking alerts

> Returns recent staking alerts detected by analytics, with filtering and pagination.

```json
{"openapi":"3.0.3","info":{"title":"Fortisx Public API","version":"1.0.0"},"tags":[{"name":"Alerts","description":"Analytical alerts about staking pool and network metric changes"}],"servers":[{"url":"https://api.fortisx.fi/v1","description":"Demo host (replace with your own in production)"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key"}},"schemas":{"AlertsResponse":{"type":"object","required":["total","limit","offset","items"],"properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Alert"}}}},"Alert":{"type":"object","required":["id","networkCode","stakingPoolId","eventType","windowMinutes","valueFrom","valueTo","unit","deltaAbs","deltaRelPct","detectedAt"],"properties":{"id":{"type":"integer"},"networkCode":{"type":"string"},"stakingPoolId":{"type":"integer"},"eventType":{"type":"string","enum":["TVL_Spike","TVL_Drop","APR_Spike","APR_Drop","Fee_Spike","Fee_Drop"]},"windowMinutes":{"type":"integer"},"valueFrom":{"type":"string"},"valueTo":{"type":"string"},"unit":{"type":"string"},"tokenSymbol":{"type":"string","nullable":true},"deltaAbs":{"type":"string"},"deltaRelPct":{"type":"string"},"detectedAt":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"BadRequestInvalidParam":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalServerError":{"description":"Unexpected server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ServiceUnavailable":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/alerts":{"get":{"tags":["Alerts"],"summary":"List staking alerts","description":"Returns recent staking alerts detected by analytics, with filtering and pagination.","parameters":[{"in":"query","name":"network","schema":{"type":"string"},"description":"Filter by network code (e.g., SOL, ETH)"},{"in":"query","name":"poolId","schema":{"type":"integer","minimum":1},"description":"Filter by staking pool ID"},{"in":"query","name":"eventType","schema":{"type":"string","enum":["TVL_Spike","TVL_Drop","APR_Spike","APR_Drop","Fee_Spike","Fee_Drop"]},"description":"Filter by alert type"},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Number of records to return"},{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"default":0},"description":"Number of records to skip"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertsResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestInvalidParam"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}
```