# Vextorium Satellite Passes

> Vextorium Satellite Passes is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-11).

Returns upcoming visible passes of a satellite (by NORAD ID) over a given geographic coordinate, including rise/set times, max elevation, and naked-eye visibility.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/satellite-passes?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-satellite-passes-bff579ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8qSbKJt5N0pulnOXZQGqf

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 vextorium-satellite-passes-bff579ea -d '<json body>'
```

Example prompt: When will the ISS pass over Madrid (40.4168°N, 3.7038°W) in the next 2 days? Show me all passes with at least 10 degrees elevation, including whether they'll be visible to the naked eye.

## When to prefer this

Choose this endpoint when you need precise, computation-backed satellite pass predictions for a specific geographic coordinate, especially for the ISS or any NORAD-catalogued satellite. It is ideal for astronomy apps, observation planners, or astrophotography scheduling. Prefer it over generic space APIs when you need naked-eye visibility flags, sunlit/dark-sky conditions, and directional rise/set data.

## Known failure modes

- Missing required lat/lon fields returns a validation error
- Invalid NORAD ID returns no results or an error
- Very short forecast window (days=0) may return empty passes array
- Locations at extreme latitudes may have no passes in the window
- API returns HTTP 402 if USDC payment is not provided via x402 protocol

## How this service works

Next passes of a satellite over a location (ISS by default, any NORAD id): rise, culmination and set times in UTC, max elevation, direction and whether it will be sunlit under a dark sky (visible to the naked eye). Orbits from CelesTrak.

## Output

A JSON object listing all predicted satellite passes over the given location within the requested window. Each pass entry includes rise time, set time, culmination time (all in UTC), direction the satellite rises from and sets to, maximum elevation angle, whether the satellite is sunlit, whether the sky is dark, and whether it is visible to the naked eye. Also includes the satellite name and data source attribution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number"
      },
      "lon": {
       "type": "number"
      },
      "days": {
       "type": "integer"
      },
      "norad": {
       "type": "integer"
      },
      "min_elevation": {
       "type": "number"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "days": {
       "type": [
        "number",
        "null"
       ]
      },
      "norad": {
       "type": [
        "number",
        "null"
       ]
      },
      "place": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "lat": {
         "type": [
          "number",
          "null"
         ]
        },
        "lon": {
         "type": [
          "number",
          "null"
         ]
        }
       }
      },
      "passes": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "to": {
          "type": [
           "null",
           "string"
          ]
         },
         "since": {
          "type": [
           "null",
           "string"
          ]
         },
         "sunlit": {
          "type": [
           "boolean",
           "null"
          ]
         },
         "dark_sky": {
          "type": [
           "boolean",
           "null"
          ]
         },
         "sets_utc": {
          "type": [
           "null",
           "string"
          ]
         },
         "rises_utc": {
          "type": [
           "null",
           "string"
          ]
         },
         "max_elevation": {
          "type": [
           "null",
         
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "days": 2,
  "norad": 25544,
  "place": {
   "lat": 40.4168,
   "lon": -3.7038
  },
  "passes": [
   {
    "to": "NE",
    "since": "SW",
    "sunlit": true,
    "dark_sky": false,
    "sets_utc": "2026-10-04T09:54:53Z",
    "rises_utc": "2026-10-04T09:48:10Z",
    "max_elevation": 60.7,
    "culminates_utc": "2026-10-04T09:51:31Z",
    "visible_to_naked_eye": false
   },
   {
    "to": "NE",
    "since": "W",
    "sunlit": true,
    "dark_sky": false,
    "sets_utc": "2026-10-04T11:31:23Z",
    "rises_utc": "2026-10-04T11:25:47Z",
    "max_elevation": 23,
    "culminates_utc": "2026-10-04T11:28:35Z",
    "visible_to_naked_eye": false
   }
  ],
  "source": "CelesTrak (orbits) and Skyfield (computation)",
  "satellite": "ISS (ZARYA)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-satellite-passes-bff579ea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)