{"uid":"cap_Gv0i9XmgdL9IeE-qpEXZQ","slug":"earthquake-intelligence-significant-events-ba014938","name":"Earthquake Intelligence – Significant Events","description":"Significant earthquakes — search USGS seismic events above an explicit significance-score threshold, with magnitude and provenance but no danger or probability claim.","url":"https://earthquakes.use.x402atlas.com/significant","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":{"days":{"type":"integer","default":30,"maximum":365,"minimum":1,"description":"Rolling UTC window in days"},"limit":{"type":"integer","default":50,"maximum":200,"minimum":1,"description":"Maximum normalized events returned"},"min_significance":{"type":"integer","default":600,"maximum":2000,"minimum":0,"description":"Minimum USGS significance score; not a probability or danger rating"}},"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","days","min_significance","limit"],"properties":{"days":{"type":"integer","maximum":365,"minimum":1,"description":"Applied rolling days"},"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_significance":{"type":"integer","maximum":2000,"minimum":0,"description":"Applied USGS significance-score threshold"}},"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":"significant-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_Dtsm8mfLwd9F5kkefUOI8","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":"Search USGS seismic events filtered by a significance-score threshold, returning magnitude, provenance, and event metadata for the most notable earthquakes in a rolling time window.","exampleAgentPrompt":"Show me the most significant earthquakes from the past 30 days — only events with a USGS significance score above 800, and return up to 100 events.","exampleUseCases":[{"title":"Daily seismic briefing for newsroom","prompt":"Pull all earthquakes from the last 7 days with a USGS significance score above 600 and limit results to 50 — I need to check if anything notable happened for today's briefing."},{"title":"High-impact earthquake research query","prompt":"I'm researching major seismic events this year — can you get me up to 200 earthquakes from the past 365 days with a significance score above 1000?"},{"title":"Real-time alert threshold monitoring","prompt":"Check for any earthquakes in the last 3 days that scored above 900 on the USGS significance scale — I want to know if anything serious just happened."}],"resultDescription":"Returns a JSON object containing: the count of matched events, the effective query identity (window start/end, days, significance threshold, limit), a list of normalized seismic events with magnitude and provenance, a staleness flag indicating whether a cached snapshot was served, any warnings, the data source, and the retrieval timestamp.","failureModes":["No events returned if significance threshold is set too high for the time window selected","Stale flag set to true when a cached snapshot is served instead of a live query","Query parameter validation errors if days exceeds 365 or min_significance exceeds 2000","Empty event list for very short time windows with high significance thresholds","Service unavailable if upstream USGS feed is unreachable"],"whenToPreferThis":"Choose this endpoint when you need to surface only the most notable or impactful seismic events by USGS significance score, rather than all earthquakes above a raw magnitude threshold. It is ideal for briefings, research, or monitoring scenarios where event importance (combining magnitude, felt reports, and media attention) matters more than magnitude alone. Use the sibling 'Recent earthquakes' endpoint if you want newest-first results filtered purely by magnitude without a significance score filter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:32:14.115Z","isFirstParty":false}