---
title: "Cross Tidal Forcing"
method: POST
path: "/api/v1/cross-physics/tidal-forcing"
---

# Cross Tidal Forcing

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

## Request

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

Tidal forcing on earthquake triggering analysis.

Tests whether earthquake occurrence is periodic at tidal frequencies
using Schuster's test and Rayleigh statistics. The p-values are valid;
mean/preferred tidal phase is withheld (null) because the phase origin
of the tidal clock is arbitrary (tide-engine audit 2026-10-12). Check
``data_source``: the default request analyses a synthetic catalogue.

## Headers

- `x-api-key` string

## Request body

- TidalForcingRequest: Tidal forcing earthquake triggering analysis.
  - `lat` number: Region center latitude
  - `lon` number: Region center longitude
  - `n_earthquakes` integer: Number of demo earthquakes
  - `constituents` string[], nullable: Tidal constituents to test
  - `use_demo` boolean: True (default) analyses a SYNTHETIC catalogue with an injected tidal signal; False fetches a real USGS catalogue. The response states which in data_source. lat/lon are not used to select the catalogue.

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