---
title: "Cross Tidal Eruption"
method: POST
path: "/api/v1/cross-physics/tidal-eruption"
---

# Cross Tidal Eruption

`POST /api/v1/cross-physics/tidal-eruption`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/cross-physics/tidal-eruption`
- Auth: none declared

Tidal modulation of volcanic eruption timing.

Tests whether eruption/tremor timing is periodic at tidal frequencies
(Schuster/Rayleigh p-values, valid). Eruption risk windows, tidal stress
and mean/peak phase are withheld (null): the stress model behind them is
not a tide model (tide-engine audit 2026-10-12). Check ``data_source``:
the default request analyses a synthetic catalogue.

## Headers

- `x-api-key` string

## Request body

- TidalEruptionRequest: Tidal modulation of volcanic eruption timing.
  - `lat` number: Volcano latitude
  - `lon` number: Volcano longitude
  - `reservoir_depth_km` number: Magma reservoir depth (km)
  - `use_demo` boolean: True (default) analyses a SYNTHETIC eruption catalogue with an injected tidal signal; False fetches real USGS volcanic seismicity. The response states which in data_source.

## 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)