# Spaceweather — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/spaceweather/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/spaceweather/get-archive-report \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/spaceweather/get-current-conditions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/spaceweather/get-daily-report \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/spaceweather/get-near-earth-asteroids \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.