# Spaceweather — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Monitor real-time space weather conditions including solar wind, sunspots, and flares, plus track near-Earth asteroids and access daily or historical reports. Stay informed about current space weather events and search through archived data to understand patterns and trends over time.

**Category:** Weather | **Website:** [spaceweather.com/](https://spaceweather.com/) | **Docs:** [parse.bot/marketplace/7b7e9c16-a1ea-4dd1-a881-1cebf44f4ab1/spaceweather-com-api](https://parse.bot/marketplace/7b7e9c16-a1ea-4dd1-a881-1cebf44f4ab1/spaceweather-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-spaceweather-com-api-7b7e9c16/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_archive_report

Get an archived daily report and space weather conditions for a specific historical date. Returns the same structure as get_daily_report (date and stories) plus a conditions object matching get_current_conditions. Dates must be in the past and within the site's archive range (typically 2000 onward).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `day` | string | Yes | Two-digit day of the month with leading zero (e.g. '15'). |
| `month` | string | Yes | Two-digit month number with leading zero (e.g. '01' for January). |
| `year` | string | Yes | Four-digit year (e.g. '2025'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-spaceweather-com-api-7b7e9c16/get_archive_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"day":"<string>","month":"<string>","year":"<string>"}'
```

### get_current_conditions

Get current space weather conditions sidebar data including solar wind speed and density, X-ray flare classifications, sunspot number, planetary K-index, interplanetary magnetic field strength, and thermosphere climate index. All values reflect the latest measurements published on the spaceweather.com homepage. Returns a single Conditions object.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-spaceweather-com-api-7b7e9c16/get_current_conditions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_daily_report

Get the daily space weather report and news stories from the homepage. Returns the current date and an array of story objects with headlines, content text, image URLs, and related links. Stories cover solar flares, geomagnetic storms, comets, and other space weather events.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-spaceweather-com-api-7b7e9c16/get_daily_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_near_earth_asteroids

Get the near-Earth asteroid encounter table from the homepage showing recent and upcoming close approaches within the next few weeks. Includes miss distance in lunar distances (LD), velocity, and estimated diameter for each object.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-spaceweather-com-api-7b7e9c16/get_near_earth_asteroids \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```