Endpoint
GET /api/v1/detections/:id
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Detection ID |
Example Request
curl http://localhost:8000/api/v1/detections/finding_abc123
Response
{
"id": "finding_abc123",
"rule_name": "flash_loan_attack",
"detector_name": "flash_loan_attack",
"severity": "CRITICAL",
"priority": "CRITICAL",
"chain": "ethereum",
"type": "rule",
"tx_hash": "0x9e5c7835e4fcd9a289820c4e42c623c4ab80bd50896b4e5b27e3c18f79be6341",
"block_number": 18450123,
"timestamp": "2025-11-11T21:30:00Z",
"description": "Flash loan attack detected: 1000 ETH borrowed",
"tags": ["defi", "flash-loan"],
"metadata": {
"tx_from": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"tx_to": "0x123f4567890abcdef1234567890abcdef123456",
"tx_value": "1000000000000000000"
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique detection ID |
rule_name | string | Name of the rule that triggered |
detector_name | string | Detector name (same as rule_name) |
severity | string | Severity level (NOTICE, WARNING, CRITICAL) |
priority | string | Priority level (same as severity) |
chain | string | Blockchain network |
type | string | Detection type (usually “rule”) |
tx_hash | string | Transaction hash |
block_number | number | Block number |
timestamp | string | Detection timestamp (ISO 8601) |
description | string | Alert message/description |
tags | array | Rule tags |
metadata | object | Additional transaction metadata |