# Steward ISS Position API

> Steward ISS Position API is a paid API for AI agents from pay.brianbooms.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-02).

Returns the International Space Station's current latitude, longitude, altitude, and velocity computed in real-time from public TLEs via SGP4 propagation

## Facts

- Endpoint: GET https://pay.brianbooms.com/api/v1/data/iss-now?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/steward-iss-position-api-26d54d07
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hjkthTuRRGSufyq9MHjE8

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 steward-iss-position-api-26d54d07
```

Example prompt: What's the ISS's current position right now — give me the latitude, longitude, altitude, and velocity as a GeoJSON feature so I can drop it on a map.

## When to prefer this

Use this endpoint when you need a fresh, propagated ISS position rather than a cached fix — it computes position locally via SGP4 at call time. Prefer it over generic ISS APIs when you need GeoJSON output directly or when freshness matters for near-real-time map overlays or pass predictions. It is a paid endpoint ($0.01 USDC via x402) so factor that in for high-frequency polling.

## Known failure modes

- Stale TLE data if CelesTrak has not updated recently, leading to slightly inaccurate positions
- Payment failure or 402 response if USDC balance is insufficient
- Invalid format parameter value returns an error or falls back to default JSON
- Service downtime on pay.brianbooms.com returns 5xx error

## How this service works

Use when an agent needs the ISS's position right now — latitude, longitude, altitude, and velocity propagated locally from public CelesTrak TLEs (SGP4), not a stale cached fix. Derived positions only; raw TLEs are never served. Optional format=geojson returns a GeoJSON Feature. Use permitted: build it into your products and services, paid or free. Raw redistribution of the feed itself is prohibited.

## Output

A JSON object (or GeoJSON Feature if format=geojson is requested) containing the ISS's current latitude, longitude, altitude (km), and velocity (km/s), propagated locally using SGP4 from the latest public CelesTrak TLEs at call time.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "format": {
   "type": "string",
   "description": "Optional: geojson for a GeoJSON Feature; omit for plain JSON. Example: geojson"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/steward-iss-position-api-26d54d07/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pay.brianbooms.com](https://www.zero.xyz/host/pay.brianbooms.com/llms.txt)
