{"uid":"cap_a6je9oAWbyZbgQgak9yYb","slug":"halowerk-space-debris-collision-check-f197e5bb","name":"Halowerk Space Debris Collision Check","description":"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.","url":"https://space.halowerk.com/v1/debris-collision","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0pTq7echuKMEa0DPPZnbd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Satellite close-approach screening","prompt":"My satellite is at position (7000, 200, 100) km with velocity (0, 7.2, 0.3) km/s and a hard-body radius of 2 m. A tracked debris object is at (7000.05, 199.8, 100.1) km moving at (0.05, 7.15, 0.28) km/s with a 0.5 m radius. Check if they'll come within combined hard-body distance over the next 86400 seconds."},{"title":"Debris avoidance maneuver decision","prompt":"Before I decide whether to execute a collision avoidance maneuver, can you check the minimum miss distance between my spacecraft at (42164, 0, 0) km doing (0, 3.07, 0) km/s with a 5 m body radius and a debris fragment at (42164.1, 0.2, 0) km doing (-0.01, 3.06, 0.01) km/s with a 1 m radius over the next two hours?"},{"title":"Constellation conjunction screening","prompt":"I have two constellation satellites that may be approaching each other — one at position (550, 6350, 2200) km velocity (-7.1, 0.4, 0.8) km/s radius 1.5 m, and another at (549.5, 6350.3, 2200.1) km velocity (-7.08, 0.38, 0.79) km/s radius 1.5 m. What's the closest they'll get in the next 600 seconds and do they collide?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:43.925Z","isFirstParty":false}