{"uid":"cap_A_v7d-bGsoex7wMcyqYBl","slug":"usgs-recent-earthquakes-lookup-a0096ea2","name":"USGS Recent Earthquakes Lookup","description":"Pay-per-request evidence and data tools: CSV validation and reconciliation, DNS/email configuration evidence, and bounded official weather, earthquake, vehicle, company and study records. Exact USDC prices, explicit JSON contracts and source provenance. No mailbox, ownership, medical or safety guarantees.","url":"https://foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev/v2/official/usgs-recent-earthquakes","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"hours":{"type":"integer","default":24,"maximum":168,"minimum":1},"limit":{"type":"integer","default":10,"maximum":20,"minimum":1},"minimum_magnitude":{"type":"number","default":2.5,"maximum":10,"minimum":-2}}},"responseSchema":{"type":"json","example":{"route":"usgs-recent-earthquakes","result":{"query":{"hours":24,"limit":5,"minimum_magnitude":2.5},"source":"USGS Earthquake Catalog","freshness":{"state":"CURRENT_RETRIEVAL","retrievedAt":"2026-09-06T00:00:00Z","cacheAgeSeconds":0,"maximumCacheSeconds":30,"recordAgeIsNotRetrievalAge":true},"sourceUrl":"https://earthquake.usgs.gov","observedAt":"2026-09-06T00:00:00Z","provenance":{"license":"US public-domain earthquake facts; no third-party media","termsUrl":"https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits","truncated":false,"attribution":"US Geological Survey and the contributing seismic network identified in each record","limitations":["Synthetic example only; identifiers and null values illustrate fields, not a live observation."],"modifications":"Selected factual fields, normalized names and bounded result count; no source ownership claimed.","upstreamCalls":1,"documentationUrl":"https://earthquake.usgs.gov/fdsnws/event/1/"},"sourceUpdatedAt":null,"normalizedResult":[{"id":"illustrative-record","place":null,"status":null,"network":null,"eventTime":null,"magnitude":null,"sourceUrl":null,"updatedAt":null,"coordinates":null}],"sourceProcessedAt":null,"rawSourceIdentifiers":[]},"observed_at":"2026-09-06T00:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JeJf7OxjMBwwyIf90wrtk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Queries USGS earthquake catalog for recent seismic events filtered by time window and minimum magnitude, returning event identifiers, source times, and revision status.","exampleAgentPrompt":"Can you pull the 10 most recent USGS earthquakes from the last 48 hours with a minimum magnitude of 3.0?","exampleUseCases":[{"title":"Post-event seismic activity check","prompt":"Were there any significant earthquakes — magnitude 4.5 or higher — in the last 24 hours? Show me up to 15 events."},{"title":"Weekly earthquake monitoring report","prompt":"Get me the top 20 strongest earthquakes recorded by USGS over the past 7 days with a minimum magnitude of 2.5 so I can compile a weekly report."},{"title":"Real-time alert threshold screening","prompt":"Check if there have been any earthquakes of magnitude 6 or greater in the past 6 hours — I want to know if anything major just happened."}],"resultDescription":"Returns a JSON object with the matched earthquake events from the USGS catalog, each including event identifiers, observed timestamps, revision/freshness status, and the query parameters used. Also includes provenance metadata such as the upstream USGS source URL, license, attribution, cache age, and retrieval timestamp.","failureModes":["Invalid hours value outside 1–168 range returns validation error","Limit above 20 or below 1 is rejected","Magnitude outside –2 to 10 range is rejected","No earthquakes matching filters returns empty normalizedResult array","USGS upstream service unavailable may cause retrieval failure","Payment not provided or insufficient USDC triggers x402 payment required response"],"whenToPreferThis":"Choose this endpoint when you need structured, bounded earthquake data from the authoritative USGS catalog with explicit freshness metadata and provenance. It is ideal for agents that need to monitor seismic activity programmatically, generate alerts, or incorporate earthquake data into reports. Prefer this over scraping USGS directly when you need normalized JSON output with caching state and attribution built in.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:40:00.639Z","isFirstParty":false}