---
title: "Usgs Earthquakes"
method: POST
path: "/v1/usgs-earthquakes"
tags: ["fresh-state", "x402", "live-data", "agent-utility"]
---

# Usgs Earthquakes

`POST /v1/usgs-earthquakes`

## Request

- Base URL: `https://api.salt19.com`
- URL: `https://api.salt19.com/v1/usgs-earthquakes`
- Auth: none declared

Query recent USGS earthquake events by lookback window and minimum magnitude and return compact live event state. Current x402 price: $0.01.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `hours` integer
  - `min_magnitude` number
  - `limit` integer

## Response `200`

Fresh-State result

## Other responses

- `400`: Invalid input
- `402`: x402 Payment Required
- `502`: Upstream state source unavailable

---

[API](https://skmtc.dev/salt19/apis/salt19-agent-utility-grid.md) · [All operations](https://skmtc.dev/salt19/apis/salt19-agent-utility-grid/llms.txt) · [OpenAPI document](https://skmtc.dev/salt19/apis/salt19-agent-utility-grid/revisions/c2520ca8ffbf?raw)