Skip to main content
GET
/
api
/
v1
/
anomalies
Anomaly Detection
curl --request GET \
  --url https://api.example.com/api/v1/anomalies
Returns anomalies detected by the Isolation Forest algorithm. The system continuously monitors all tracked coins for unusual behavior in price, volume, funding, and OI patterns. Anomalies are enriched with current price data for context.

​
Parameters

ParameterTypeDefaultDescription
hoursnumber24Lookback window in hours (max 168 = 7 days)
severitystring—Filter by severity: warning or critical
symbolstring—Filter by trading pair (optional)
limitnumber50Maximum number of results (max 200)

​
Example Request

curl -X GET "https://krovn.io/api/v1/anomalies?hours=24&severity=critical&limit=5" \
  -H "X-API-Key: your_api_key"

​
Example Response

{
  "count": 2,
  "window": "24h",
  "anomalies": [
    {
      "id": 1542,
      "discoveredAt": "2026-03-21T11:45:00.000Z",
      "algorithm": "isolation_forest",
      "symbol": "DOGEUSDT",
      "confidence": 0.94,
      "severity": "critical",
      "anomalyScore": -0.82,
      "priceAtDetection": 0.1245,
      "currentPrice": 0.1289,
      "topFeatures": [
        "funding_rate_zscore",
        "oi_change_1h",
        "volume_spike"
      ]
    },
    {
      "id": 1538,
      "discoveredAt": "2026-03-21T10:20:00.000Z",
      "algorithm": "isolation_forest",
      "symbol": "ARBUSDT",
      "confidence": 0.88,
      "severity": "critical",
      "anomalyScore": -0.76,
      "priceAtDetection": 1.05,
      "currentPrice": 1.08,
      "topFeatures": [
        "oi_change_4h",
        "ls_ratio_divergence"
      ]
    }
  ],
  "timestamp": "2026-03-21T12:30:00.000Z"
}
Anomaly scores closer to -1.0 indicate stronger anomalies. The topFeatures array shows which data dimensions drove the anomaly detection. Compare priceAtDetection with currentPrice to see how price moved since the anomaly was detected.