# BRAINIAC Satellite Orbit Change Detection

> BRAINIAC Satellite Orbit Change Detection is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-12).

Compares before/after TLE orbital elements for one or more satellites and detects meaningful changes in orbital parameters such as apogee, perigee, inclination, period, and RAAN.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/space-intelligence/satellite-orbit-change-detect?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-satellite-orbit-change-detection-5a3edc1e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IQG8S8O5VGXacHX7PUK9b

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 brainiac-satellite-orbit-change-detection-5a3edc1e -d '<json body>'
```

Example prompt: Compare these two TLEs for the ISS (NORAD ID 25544) — one from yesterday and one from today — and tell me if its orbit changed: did it maneuver, and by how much did the apogee, perigee, inclination, and period shift?

## When to prefer this

Use this endpoint when you need a fast, no-account, pay-per-call analysis of satellite orbital element changes using caller-supplied TLE data, without needing a commercial orbital API key or paid imagery provider. It is ideal for agents that already have TLE snapshots (e.g., from CelesTrak) and want to programmatically detect maneuvers, altitude changes, or orbital drift. Prefer this over manual TLE diffing scripts when you need structured JSON findings with coded observations and uncertainty notes. Not suitable when high-fidelity SGP4/SDP4 propagation or confirmed maneuver attribution is required.

## Known failure modes

- Malformed or invalid TLE lines cause parsing errors and no comparison
- Missing 'side' field (before/after) on TLE entries makes pairing impossible
- Stale TLE elements increase positional uncertainty and may produce false positives or missed detections
- Very small orbital changes below threshold may not be flagged as changes
- Simplified Keplerian propagator omits drag and perturbations, making timing and geometry approximate
- Supplying mismatched NORAD IDs for before/after pairs produces meaningless delta values
- Exceeding 200 TLE items in one request returns a validation error

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object listing each satellite pair checked, with before/after epochs, delta values for apogee, perigee, inclination, RAAN, period, and mean motion, a boolean changed flag, findings list with coded observations, overall status, count of changed satellites, orbital model used, and uncertainty notes explaining propagator limitations.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "file": {
   "type": "object",
   "required": [
    "fileBase64"
   ],
   "properties": {
    "role": {
     "type": "string",
     "maxLength": 80
    },
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json",
      "application/octet-stream"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "tles": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "name": {
      "type": "string",
      "maxLength": 160
     },
     "side": {
      "enum": [
       "before",
       "after",
       "left",
       "right",
       "a",
       "b"
      ],
      "type": "string"
     },
     "text": {
      "type": "string",
      "maxLength": 400
     },
     "epoch": {
      "type": "string",
      "maxLength": 40
     },
     "line1": {
      "type": "string",
      "maxLength": 120
     },
     "line2": {
      "type": "string",
      "maxLength": 120
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "noradId": {
      "type": "string",
      "maxLength": 20
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "files": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "fileBase64"
    ],
    "properties": {
     "role": {
      "type": "string",
      "maxLength": 80
     },
     "filename": {
      "type": "string",
      "maxLength": 180,
      "minLength": 1
     },
     "mediaType": {
      "enum": [
       "text/plain",
       "text/csv",
       "application/json",
       "application/octet-stream"
      ],
      "type": "string"
     },
     "fileBase64": {
      "type": "string",
      "maxLength": 12000000,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 20
  },
  "images": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLeng
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "name": "ISS (ZARYA)",
    "source": "Caller-supplied CelesTrak snapshot; Caller-supplied CelesTrak snapshot",
    "changed": true,
    "noradId": "25544",
    "afterEpoch": "2026-11-05T08:52:07.404Z",
    "beforeEpoch": "2026-11-04T08:52:07.404Z",
    "deltaRaanDeg": 0.6013,
    "deltaApogeeKm": -2.4073,
    "deltaPerigeeKm": -2.4229,
    "deltaPeriodMin": -0.0495,
    "uncertaintyNote": "Change flags use mean-element deltas only; they are not maneuver confirmation.",
    "afterEpochAgeHours": -11.8687,
    "beforeEpochAgeHours": 12.1313,
    "deltaInclinationDeg": 0.0671,
    "deltaMeanMotionRevPerDay": 0.0083
   }
  ],
  "status": "compared",
  "findings": [
   {
    "code": "orbit_change",
    "kind": "observation",
    "detail": "Mean-element differences exceed local detection thresholds.",
    "subject": "25544"
   }
  ],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "pairCount": 1,
  "changeCount": 1,
  "limitations": [
   "Orbital elements, observers, imagery metadata, weather rows, and catalog objects are copied only from labeled fields supplied by the caller, or from key-free CelesTrak GP / Open-Meteo responses when explicitly requested.",
   "No commercial satellite imagery provider or paid orbital API is used and no API key is required.",
   "Pass and conjunction geometry use a simplified Keplerian propagator from TLE mean elements, not full SGP4/SDP4. Treat timing and miss-distance values as approximate and communicate residual orbital uncertainty.",
   "TLE freshness is reported from the element epoch when parseable. Stale elements increase positional uncertainty.",
   "Earth-observation change, cloud, quality, and license results use only caller-supplied image metadata/statistics. Pixels are not downloaded from commercial archives."
  ],
  "orbitalModel": "simplified-keplerian-from-tle-mean-elements",
  "apiKeyRequired": false,
  "celestrakFetched": false,
  "openMeteoFetched": false,
  "paidProviderUsed": false,
  "paidOrbitalApiUsed": false,
  "commercialImageryUsed": false,
  "orbitalUncertaintyNote": "Positions and pass times are approximate. Simplified Keplerian propagation from TLE mean elements omits drag and perturbation modeling used by SGP4. Uncertainty grows with element age."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-satellite-orbit-change-detection-5a3edc1e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
