# Halowerk Space Debris Collision Check

> Halowerk Space Debris Collision Check is a paid API for AI agents from space.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Analytically propagates two Cartesian states with constant velocity to compute time of closest approach and determine whether the miss distance falls within the combined hard-body radii of the two objects.

## Facts

- Endpoint: POST https://space.halowerk.com/v1/debris-collision
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-space-debris-collision-check-f197e5bb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_a6je9oAWbyZbgQgak9yYb

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-space-debris-collision-check-f197e5bb -d '<json body>'
```

Example prompt: Check if a 3 m radius satellite at position (6800, 0, 0) km moving at (0, 7.5, 0) km/s will collide with a 1 m radius debris object at (6800.01, 0.5, 0) km moving at (0.1, 7.4, 0.2) km/s within the next 3600 seconds.

## When to prefer this

Use this endpoint when you need a fast, zero-cost-overhead analytical screen of whether two objects on known linear trajectories come within hard-body distance — e.g., pre-filtering a large catalog for detailed follow-up, or doing a quick sanity check on Cartesian state data. Do not use for operational conjunction assessment, probabilistic collision avoidance, or any scenario where orbital perturbations, maneuver uncertainty, or covariance matter.

## Known failure modes

- Invalid or missing position/velocity vectors returns a 400 validation error
- Horizon exceeding 604800 seconds (7 days) is rejected as out of range
- Objects on identical trajectories (zero relative velocity) may return degenerate closest approach times
- Negative radius values rejected by schema validation
- Result is physically meaningless for real conjunction assessment because gravity, atmospheric drag, covariance, and nonlinear dynamics are all ignored

## How this service works

Propagates two caller-supplied Cartesian states with constant velocity, analytically finds the clamped time of closest approach, and compares miss distance with combined hard-body radius. It ignores gravity, covariance, maneuver uncertainty, tracking error, and nonlinear dynamics and is not an operational conjunction assessment.

## Output

Returns the clamped time of closest approach within the specified horizon, the computed miss distance in km or m, a boolean collision flag indicating whether miss distance is less than or equal to the combined hard-body radii, and the sum of both object radii used as the collision threshold.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "horizon_seconds": {
   "type": "number",
   "maximum": 604800,
   "minimum": 0
  },
  "primary_radius_m": {
   "type": "number",
   "maximum": 10000,
   "minimum": 0
  },
  "secondary_radius_m": {
   "type": "number",
   "maximum": 10000,
   "minimum": 0
  },
  "primary_position_km": {
   "type": "object",
   "required": [
    "x",
    "y",
    "z"
   ],
   "properties": {
    "x": {
     "type": "number",
     "maximum": 1000000000000,
     "minimum": -1000000000000
    },
    "y": {
     "type": "number",
     "maximum": 1000000000000,
     "minimum": -1000000000000
    },
    "z": {
     "type": "number",
     "maximum": 1000000000000,
     "minimum": -1000000000000
    }
   },
   "additionalProperties": false
  },
  "primary_velocity_km_s": {
   "type": "object",
   "required": [
    "x",
    "y",
    "z"
   ],
   "properties": {
    "x": {
     "type": "number",
     "maximum": 1000000000000,
     "minimum": -1000000000000
    },
    "y": {
     "type": "number",
     "maximum": 1000000000000,
     "minimum": -1000000000000
    },
    "z": {
     "type": "number",
     "maximum": 1000000000000,
     "minimum": -1000000000000
    }
   },
   "additionalProperties": false
  },
  "secondary_position_km": {
   "type": "object",
   "required": [
    "x",
    "y",
    "z"
   ],
   "properties": {
    "x": {
     "type": "number",
     "maximum": 1000000000000,
     "minimum": -1000000000000
    },
    "y": {
     "type": "number",
     "maximum": 1000000000000,
     "minimum": -1000000000000
    },
    "z": {
     "type": "number",
     "maximum": 1000000000000,
     "minimum": -1000000000000
    }
   },
   "additionalProperties": false
  },
  "secondary_velocity_km_s": {
   "type": "object",
   "required": [
    "x",
    "y",
    "z"
   ],
   "properties": {
    "x": {
     "type": "number",
     "maximum": 1000000000000,
     "minimum": -1000000000000
    },
    "y": {
     "type": "number",
     "maximum": 1000000000000,
     "minimum": -1000000000000
    },
    "z": {
     "type": "number",
     "maximum": 1000000000000,
     "minimum": -1000000000000
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-space-debris-collision-check-f197e5bb/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)