Recent earthquakes API: USGS quakes for the past day or week
Recent earthquakes worldwide from the US Geological Survey: magnitude, place, time, depth, coordinates, tsunami flag and USGS link, for the past day or week, filtered by minimum magnitude (2.5, 4.5 or significant). Use for alerts, news and travel checks.
When to use it
- Alerts, news and travel checks
- Filter by minimum magnitude 2.5, 4.5 or significant
- Get magnitude, place, time, depth, coordinates, tsunami flag and USGS link
Inputs
| Name | Type | Description |
|---|---|---|
period | string | hour, day (default), week or month |
minMagnitude | string | Smallest magnitude to include, 0-10 (default 2.5), or significant |
Request
Over HTTP, with a card key from /credits:
curl -H "Authorization: Bearer adt_…" "https://tools.funwords.eu/earthquakes?period=day"
Or one of your 25 free calls, no key:
curl "https://tools.funwords.eu/earthquakes?period=day&trial=1"
Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.
Example result
{
"period": "day",
"minMagnitude": "4.5",
"count": 8,
"earthquakes": [
{
"magnitude": 5.1,
"place": "100 km S of …",
"time": "2026-10-18T03:12:00.000Z",
"depthKm": 10,
"lat": -6.1,
"lon": 130.2,
"tsunami": false,
"url": "https://earthquake.usgs.gov/…"
}
]
}
From an AI agent (MCP)
Add the MCP server to Claude, Cursor or any MCP client. This tool is earthquakes, and the first 25 successful calls are free:
https://tools.funwords.eu/mcp
Questions
Where does the data come from?
The US Geological Survey feeds for the past day or week.
How do I pay?
Each successful call costs $0.01; failed calls are not charged. The first 25 calls are free. Then pay with card credits (from $1; the key goes in an Authorization header or, for clients that can only fetch a URL, as api_key= in the URL) or per call in USDC over x402 or MPP. No account is needed.