# Halowerk Dark Fleet Detection Scorer

> Halowerk Dark Fleet Detection Scorer is a paid API for AI agents from space.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Computes a bounded dark-fleet suspicion score for vessel tracks by combining AIS gap duration, unmatched satellite detections, night-observation fraction, and position discrepancy into a single normalized metric.

## Facts

- Endpoint: POST https://space.halowerk.com/v1/dark-fleet-detect
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-dark-fleet-detection-scorer-8101ef49
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__sshCeRBgmWzpXUsV-n6S

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability halowerk-dark-fleet-detection-scorer-8101ef49 -d '<json body>'
```

Example prompt: Score these 3 vessel tracks for dark fleet suspicion: track 'VES-001' had a 72-hour AIS gap, 45 satellite detections, 30 unmatched, 0.8 night fraction, and 15 km position discrepancy; track 'VES-002' had 12 hours gap, 10 detections, 2 unmatched, 0.2 night fraction, and 2 km discrepancy; track 'VES-003' had 200 hours gap, 100 detections, 90 unmatched, 0.95 night fraction, and 500 km discrepancy — flag anything scoring above 0.7 for review.

## When to prefer this

Choose this endpoint when you need a fast, deterministic, bounded suspicion score for one or many vessel tracks based on structured AIS and satellite detection features. It is ideal for batch compliance screening, triage pipelines, or automated alerting workflows where you have pre-computed track-level features and need a normalized score to rank or filter by. Prefer alternatives (dedicated maritime intelligence platforms or vessel identification services) when you need vessel identity resolution, cross-track linking, evidentiary-quality analysis, or actionable legal conclusions.

## Known failure modes

- Missing required track fields (track_id, ais_gap_hours, etc.) → 400 validation error
- Array with 0 items or more than 10,000 items → schema validation failure
- Values outside allowed ranges (e.g. night_detection_fraction > 1) → 400 error
- review_threshold outside 0–1 → validation error
- Payment not provided or insufficient → 402 payment required
- Service unavailable or timeout for large batches → 5xx error

## How this service works

Combines caller-supplied AIS gap duration, unmatched satellite detections, night-observation fraction, and position discrepancy into a bounded score. It does not identify a vessel, link detections, establish illegal activity, or replace maritime intelligence review.

## Output

Returns a bounded suspicion score (0–1) per vessel track reflecting the likelihood of dark fleet behavior based on the four input signals (AIS gap, unmatched satellite detections, night-observation fraction, position discrepancy). Tracks meeting or exceeding the caller-supplied review threshold are flagged for analyst attention. Does not identify vessels, link detections across tracks, establish legal findings, or substitute for professional maritime intelligence review.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tracks": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "track_id",
     "ais_gap_hours",
     "satellite_detection_count",
     "unmatched_detection_count",
     "night_detection_fraction",
     "position_discrepancy_km"
    ],
    "properties": {
     "track_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
     },
     "ais_gap_hours": {
      "type": "number",
      "maximum": 8760,
      "minimum": 0
     },
     "position_discrepancy_km": {
      "type": "number",
      "maximum": 100000,
      "minimum": 0
     },
     "night_detection_fraction": {
      "type": "number",
      "maximum": 1,
      "minimum": 0
     },
     "satellite_detection_count": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0
     },
     "unmatched_detection_count": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 10000,
   "minItems": 1
  },
  "review_threshold": {
   "type": "number",
   "maximum": 1,
   "minimum": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-dark-fleet-detection-scorer-8101ef49/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from space.halowerk.com](https://www.zero.xyz/host/space.halowerk.com/llms.txt)