# Recent Earthquakes API
GET/v1/sensordata/quakes/recent
Earthquakes from the USGS feed in the last `hours` (1 to 720), optionally at or above `min_mag` and within radius_km of a point, newest first, with magnitude and depth as integers (milli). Refreshes every 60 seconds.
Price
$0.005/ callEdge cache
30s
Uptime 24h
100.00%
p95
272ms
MCP tool
sensordata_quakes-recent
The Recent Earthquakes API provides earthquakes data from the USGS feed. It returns earthquakes from the last specified number of hours, optionally filtered by minimum magnitude and location. The data is refreshed every 60 seconds. Parameters include min_mag, hours, lat, lon, radius_km, and limit. The API costs $0.005 per request.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| min_mag | query | number | |
| hours | query | integer = 24 | |
| lat | query | number | |
| lon | query | number | |
| radius_km | query | number | |
| limit | query | integer = 100 |
Code
curl
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/sensordata/quakes/recent"
# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/sensordata/quakes/recent" -H "PAYMENT-SIGNATURE: $X402_PAYMENT"TypeScript · @x402/fetch
// npm i @x402/fetch @x402/core @x402/evm viem
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = x402Client.fromConfig({ schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(PRIVATE_KEY)) }] });
const pay = wrapFetchWithPayment(fetch, client);
const data = await (await pay("https://api.realtimeapi.ai/v1/sensordata/quakes/recent")).json();
console.log(data);Python · x402
# pip install "x402[requests,evm]==2.27.0" eth-account
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import register_exact_evm_client
client = x402ClientSync()
register_exact_evm_client(client, EthAccountSigner(Account.from_key(PRIVATE_KEY)))
session = x402_requests(client)
print(session.get("https://api.realtimeapi.ai/v1/sensordata/quakes/recent").json())With an API key
curl "https://api.realtimeapi.ai/v1/sensordata/quakes/recent" -H "X-API-Key: $RTAPI_KEY"Frequently asked questions
What is the data source?
USGS feed
How often is the data refreshed?
Every 60 seconds
What is the cost per request?
$0.005
What parameters can be used to filter the data?
min_mag, hours, lat, lon, radius_km, limit