# Helioviewer Solar Images and Events API

> Helioviewer: solar telescope images from SDO, SOHO and others, and solar events like flares and CMEs

- Vendor: `helioviewersolarimagesandevent` · version 1.0 · category Science · tags solar images api, sun images api, sdo api, soho api, solar flares api, space weather api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/helioviewersolarimagesandevent
- This document: https://apiclay.com/docs/helioviewersolarimagesandevent.md
- OpenAPI 3.1: https://apiclay.com/api/helioviewersolarimagesandevent/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `helioviewersolarimagesandevent`
- Updated: 2026-11-18

## About

## Helioviewer Solar Images and Events API

The public API of Helioviewer, the solar image archive run with NASA and ESA: the image closest to a date from any instrument and wavelength (SDO AIA and HMI, SOHO, STEREO, GOES SUVI and others), with its id, date, scale and size; and solar events in a time window from the event knowledge base and the CCMC space-weather database, such as active regions, flares, coronal mass ejections and filaments.

Data comes from **helioviewer.org** (https://helioviewer.org). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/closest-image?date=2026-11-01T00:00:00Z&amp;sourceId=14` (SDO AIA 335), then `https://api.helioviewer.org/v2/getJP2Image/?id=` for the image itself; `/events?startTime=2026-11-01T00:00:00Z&amp;sources=CCMC`.

### Routes

#### GET `/closest-image` - Closest image
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| date | query | string | yes | ISO time, e.g. `2026-11-01T00:00:00Z`. |
| sourceId | query | number | yes | Instrument and wavelength id, e.g. `14` (SDO AIA 335), `13` (AIA 304), `10` (AIA 171), `19` (HMI magnetogram). |

Returns: `id`, `date`, `name`, `scale`, `width`, `height`, `refPixelX`, `refPixelY`, `rsun`, `sunCenterOffsetParams`, `layeringOrder`.

#### GET `/events` - Events
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| startTime | query | string | yes | ISO time; the window runs one day from it. |
| sources | query | string | no | `HEK`, `CCMC` or `RHESSI`; all without it. |

Returns: Array of event types (`name`, `pin`) with `groups` (source, contact) and `data`: each event's `id`, `label`, times, position and source details. All sources together can pass 1 MB.

### Caveats

- Images are public scientific data; credit the observatory (e.g. NASA SDO) when you reuse them.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by helioviewer.org.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /closest-image — Closest image
- Gateway: `GET https://api.apiclay.com/v1/api/helioviewersolarimagesandevent/closest-image`
- Public query params: `date` (string, required), `sourceId` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /events — Events
- Gateway: `GET https://api.apiclay.com/v1/api/helioviewersolarimagesandevent/events`
- Public query params: `startTime` (string, required), `sources` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/helioviewersolarimagesandevent/closest-image?date=<date>&sourceId=<sourceId>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
