{"uid":"cap_2pbHnGXcdCbwNw2XbFtY3","slug":"usgs-real-time-earthquake-feed-7fbd555e","name":"USGS Real-Time Earthquake Feed","description":"Latest earthquakes from the USGS real-time catalog (public domain, updated within minutes). Query: ?minmagnitude=4.5&limit=20; optional starttime/endtime (ISO 8601), geographic filter latitude+longitude+maxradiuskm, alertlevel=green|yellow|orange|red (PAGER). Returns a normalized list: magnitude, place, UTC time, coordinates, depth, tsunami flag, significance. 5 min cache.","url":"https://x402-datashop-production.up.railway.app/v1/geo/quakes","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":20,"maximum":100,"minimum":1},"endtime":{"type":"string","description":"ISO 8601, e.g. 2026-07-13"},"latitude":{"type":"number","description":"Center of radius filter"},"longitude":{"type":"number","description":"Center of radius filter"},"starttime":{"type":"string","description":"ISO 8601, e.g. 2026-07-01"},"alertlevel":{"enum":["green","yellow","orange","red"],"type":"string"},"maxradiuskm":{"type":"number","description":"Radius in km around latitude/longitude"},"minmagnitude":{"type":"number","default":4.5,"maximum":10,"minimum":-1}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VdPLIjua-eBnFUnHyuzMc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns recent earthquakes from the USGS real-time catalog filtered by magnitude, time range, location radius, and PAGER alert level","exampleAgentPrompt":"Show me all earthquakes above magnitude 5.0 within 800 km of Tokyo (latitude 35.68, longitude 139.69) between July 1 and July 13, 2026, up to 20 results — flag any with a yellow or higher PAGER alert level.","exampleUseCases":null,"resultDescription":"A normalized list of recent earthquakes, each with magnitude, descriptive place name, UTC occurrence time, geographic coordinates (lat/lon), depth in km, a boolean tsunami flag, and a significance score — filtered to match the query parameters, with up to 100 results from a 5-minute-cached USGS feed.","failureModes":["No earthquakes match the filter criteria — returns an empty list","Invalid ISO 8601 date format for starttime/endtime — returns a 400 error","latitude/longitude provided without maxradiuskm or vice versa — geographic filter may be ignored or error","limit exceeds 100 — capped or rejected","USGS upstream feed temporarily unavailable — may return 502 or stale cached data"],"whenToPreferThis":"Use this endpoint when you need structured, normalized earthquake data from the authoritative USGS real-time catalog, especially when filtering by magnitude threshold, geographic radius around a point, time window, or PAGER civil alert level. Prefer over raw USGS GeoJSON API when you want a pre-normalized response without parsing GeoJSON feature collections yourself. Best for agent workflows that need to monitor seismic hazards, alert on significant earthquakes, or enrich location-aware disaster-risk analyses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:45:16.070Z","isFirstParty":false}