{"uid":"cap_c-n825t57JyvQ3PbvHjvz","slug":"earthquake-intelligence-recent-seismic-events-475c8d3c","name":"Earthquake Intelligence – Recent Seismic Events","description":"Recent earthquakes — search newest-first USGS seismic events by rolling time window and minimum magnitude, with revision, freshness, and provenance.","url":"https://earthquakes.use.x402atlas.com/recent","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"],"type":"string"},"queryParams":{"type":"object","properties":{"hours":{"type":"integer","default":24,"maximum":720,"minimum":1,"description":"Rolling UTC window in hours"},"limit":{"type":"integer","default":100,"maximum":200,"minimum":1,"description":"Maximum normalized events returned"},"min_magnitude":{"type":"number","default":2.5,"maximum":10,"minimum":-2,"description":"Minimum USGS preferred magnitude"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["operation","schema_version","query","count","events","source","retrieved_at","stale","warnings"],"properties":{"count":{"type":"integer","maximum":200,"minimum":0,"description":"Number of normalized events returned"},"query":{"type":"object","required":["window_start","window_end","hours","min_magnitude","limit"],"properties":{"hours":{"type":"integer","maximum":720,"minimum":1,"description":"Applied rolling hours"},"limit":{"type":"integer","maximum":200,"minimum":1,"description":"Applied event limit"},"window_end":{"type":"string","format":"date-time","description":"Inclusive UTC end bucket used for source query and cache identity"},"window_start":{"type":"string","format":"date-time","description":"Inclusive UTC start of the effective bucketed window"},"min_magnitude":{"type":"number","maximum":10,"minimum":-2,"description":"Applied minimum preferred magnitude"}},"description":"Normalized effective query identity used for source and cache selection","additionalProperties":false},"stale":{"type":"boolean","description":"True only when an older validated exact-query snapshot was served after source failure"},"_atlas":{"type":"object","required":["docs"],"properties":{"docs":{"type":"string","format":"uri","maxLength":512,"description":"Documentation URL for this bridge"},"related":{"type":"array","items":{"type":"object","required":["bridge","url","docs","summary"],"properties":{"url":{"type":"string","format":"uri","maxLength":512,"description":"Related route URL"},"docs":{"type":"string","format":"uri","maxLength":512,"description":"Related bridge documentation URL"},"bridge":{"type":"string","maxLength":64,"description":"Related bridge name"},"summary":{"type":"string","maxLength":256,"description":"Short capability summary"}},"description":"One related Atlas route","additionalProperties":false},"maxItems":3,"description":"Bounded related Atlas routes"}},"description":"Atlas documentation and related-route metadata added after deployment","additionalProperties":false},"events":{"type":"array","items":{"type":"object","required":["id","occurred_at","updated_at","magnitude","magnitude_type","place","longitude","latitude","depth_km","tsunami","significance","felt_reports","alert_level","status","event_type","official_url","source_network"],"properties":{"id":{"type":"string","description":"Preferred public event identifier"},"place":{"type":["string","null"],"description":"USGS textual place description, or null when unknown"},"status":{"type":["string","null"],"description":"USGS review status when supplied, or null"},"tsunami":{"type":"boolean","description":"USGS tsunami flag; it is not a tsunami warning or prediction"},"depth_km":{"type":"number","maximum":1000,"minimum":-100,"description":"Reported source depth in kilometers"},"latitude":{"type":"number","maximum":90,"minimum":-90,"description":"Epicenter latitude in decimal degrees"},"longitude":{"type":"number","maximum":180,"minimum":-180,"description":"Epicenter longitude in decimal degrees"},"magnitude":{"type":["number","null"],"description":"USGS preferred magnitude, or null when unknown"},"event_type":{"type":["string","null"],"description":"USGS seismic event type when supplied, or null"},"updated_at":{"type":"string","format":"date-time","description":"UTC time the preferred event record was last revised"},"alert_level":{"type":["string","null"],"description":"USGS PAGER alert level when supplied, or null"},"occurred_at":{"type":"string","format":"date-time","description":"UTC origin time when rupture began"},"felt_reports":{"type":["integer","null"],"description":"Number of USGS DYFI felt reports, or null"},"official_url":{"type":["string","null"],"description":"Validated inert official USGS HTTPS event-page URL, or null; never fetched by this bridge"},"significance":{"type":"integer","minimum":0,"description":"USGS significance score; not probability, damage, or danger"},"magnitude_type":{"type":["string","null"],"description":"USGS preferred magnitude method, or null when unknown"},"source_network":{"type":["string","null"],"description":"Preferred contributing network code, or null"}},"additionalProperties":false},"maxItems":200,"description":"Deduplicated events ordered by occurred time descending then ID"},"source":{"type":"object","required":["name","generated_at"],"properties":{"name":{"type":"string","const":"USGS","description":"Official source organization"},"generated_at":{"type":"string","format":"date-time","description":"USGS source-generation or event-update time"}},"description":"Official USGS provenance for the served normalized snapshot","additionalProperties":false},"warnings":{"type":"array","items":{"type":"string","description":"Actionable interpretation warning"},"description":"Revision, freshness, source-link, and safety limitations"},"operation":{"type":"string","const":"recent-earthquakes","description":"Stable route operation"},"retrieved_at":{"type":"string","format":"date-time","description":"UTC time this validated snapshot was retrieved"},"schema_version":{"type":"string","const":"usgs-earthquake-v1","description":"Pinned USGS normalization contract"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2oisxTBTlDQNbH2uUzEOp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the most recent USGS earthquake events within a rolling UTC time window, filtered by minimum magnitude, newest-first, with freshness and provenance metadata.","exampleAgentPrompt":"Show me the most recent earthquakes from USGS in the past 48 hours with a minimum magnitude of 3.5, returning up to 50 events.","exampleUseCases":[{"title":"Real-time seismic alert dashboard","prompt":"Pull all earthquakes with magnitude 4 or higher that occurred in the last 12 hours from USGS and give me a list, newest first — I want to know how many there were and if the data is fresh."},{"title":"Weekly earthquake activity summary","prompt":"Get me up to 200 earthquake events from the past 168 hours with a minimum magnitude of 2.5 so I can summarize global seismic activity for this week's report."},{"title":"Low-magnitude micro-seismic monitoring","prompt":"Fetch the latest USGS seismic events from the past 6 hours, including micro-earthquakes down to magnitude 0, with a limit of 100 events so I can check for unusual low-level activity."}],"resultDescription":"A JSON object containing: a normalized list of earthquake events (up to 200) sorted newest-first, each with USGS event details and preferred magnitude; a count of returned events; the effective query window (start/end timestamps, hours, min_magnitude, limit); a staleness flag indicating whether a cached snapshot was served due to source failure; provenance/source metadata; and a retrieval timestamp.","failureModes":["Source unavailability: USGS feed unreachable — endpoint may serve a stale validated snapshot (stale: true) or return an error","No events found: valid query but zero earthquakes match the magnitude/time criteria — returns empty events array with count 0","Invalid parameters: hours outside 1–720, limit outside 1–200, or magnitude outside -2–10 — returns validation error","Rate limiting or payment failure: x402 payment not processed — request rejected before data is returned"],"whenToPreferThis":"Use this endpoint when you need the most recent earthquake events globally from USGS, queried by a rolling time window and minimum magnitude threshold, with built-in freshness signaling and provenance. Prefer this over the sibling 'significant earthquakes' endpoint when you want raw magnitude-based filtering rather than USGS significance-score filtering, or when recency and newest-first ordering is the primary concern.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:37:31.901Z","isFirstParty":false}