Detect sensor-event anomalies API

Detect anomalies in caller-supplied sensor telemetry using thresholds, baselines, and local standard-deviation rules. Anomalies are not confirmed physical incidents.

The Detect sensor-event anomalies operation is part of the Physical & IoT Security API on BRAINIAC.software. Detect anomalies in caller-supplied sensor telemetry using thresholds, baselines, and local standard-deviation rules. Anomalies are not confirmed physical incidents. It is exposed as POST /api/v1/physical-security/sensor-event-anomaly-detect and priced at $0.04 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: Caller-supplied physical/IoT event logs and telemetry processed locally Limitations: Physical security systems are not contacted and devices are never controlled. Anomalies are not labeled confirmed physical incidents without sufficient multi-signal evidence. Temporal correlation and anomaly rules run locally over supplied records only. Missing telemetry values are reported as missing, not invented. No paid physical-security feed is used and no API key is required. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Detect unusual door-access patterns, Detect tailgating signals, Detect perimeter-breach signals, Detect camera-tampering signals. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.04 USDC
/api/v1/physical-security/sensor-event-anomaly-detect

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/physical-security/sensor-event-anomaly-detect" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "anomalyStdev": 3,
  "events": [
    {
      "id": "S1",
      "at": "2026-11-04T20:00:00.000Z",
      "category": "sensor",
      "deviceId": "temp-1",
      "eventType": "temperature",
      "value": 21,
      "baseline": 21,
      "unit": "C",
      "source": "Caller-supplied"
    },
    {
      "id": "S2",
      "at": "2026-11-04T20:05:00.000Z",
      "category": "sensor",
      "deviceId": "temp-1",
      "eventType": "temperature",
      "value": 22,
      "baseline": 21,
      "unit": "C",
      "source": "Caller-supplied"
    },
    {
      "id": "S3",
      "at": "2026-11-04T20:10:00.000Z",
      "category": "sensor",
      "deviceId": "temp-1",
      "eventType": "temperature",
      "value": 21.5,
      "baseline": 21,
      "unit": "C",
      "source": "Caller-supplied"
    },
    {
      "id": "S4",
      "at": "2026-11-04T20:15:00.000Z",
      "category": "sensor",
      "deviceId": "temp-1",
      "eventType": "temperature",
      "value": 48,
      "baseline": 21,
      "threshold": 30,
      "unit": "C",
      "labels": [
        "anomaly"
      ],
      "source": "Caller-supplied"
    }
  ]
}
JSON

An unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.

FAQ

  • Do I need an API key? No. Pay the listed USDC amount with x402.
  • What network? Base (eip155:8453), USDC.
  • Is this an official determination? No. Results are for human review against the cited sources.

Related APIs

Physical & IoT Security APIFull docsHow it works