---
title: "Predict Volcano"
method: POST
path: "/api/v1/predict/volcano"
---

# Predict Volcano

`POST /api/v1/predict/volcano`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/predict/volcano`
- Auth: none declared

Volcano seismic analysis of YOUR record: RSAM, tremor, events, a heuristic score.

Computes RSAM, tremor episodes, rule-based + self-supervised event classes, an
alert level and a heuristic eruption-probability SCORE from the seismic record
the caller supplies in `data` (samples x stations, >= 60 s, sample interval `dt`).
The score is a hand-weighted sum of seismic indicators
(volcano.analyze.estimate_eruption_probability); it has not been calibrated
against eruption outcomes and is not a forecast.

No `data` -> HTTP 422. Until 2026-10-14 this endpoint ignored the caller and
analysed server-generated random numbers (np.random.randn), unlabelled.

Pricing (unchanged): $10K-$50K/yr.

## Headers

- `x-api-key` string

## Request body

- VolcanoPredictRequest: Volcano seismic analysis request -- computed ONLY from the caller's `data`. Until 2026-10-14 there was no `data` field: the endpoint analysed np.random.randn(n_samples, n_stations) and returned it unlabelled.
  - `data` array[], nullable: REQUIRED. Seismic record, shape (samples, stations), at least 60 s long (the RSAM window). The server generates no input.
    - number[]
  - `n_samples` integer, nullable: Ignored -- the shape is taken from `data` (kept for backward compatibility).
  - `n_stations` integer, nullable: Ignored -- the shape is taken from `data`.
  - `dt` number: Sample interval of `data` (s)
  - `volcano_name` string: Label echoed in the result

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)