{"uid":"cap_kVtqqZDUn8GEipp1JrMJQ","slug":"usgs-earthquake-changes-feed-aba2e37a","name":"USGS Earthquake Changes Feed","description":"USGS earthquakes (M4.5+, past week) with magnitude, location, depth, tsunami flag, and a 1-10 significance score. Filter ?min_significance=8 for the largest events.","url":"https://oracles-production.up.railway.app/v1/earthquakes/changes","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":{"limit":{"type":"integer","maximum":500,"minimum":1},"since":{"type":"string","format":"date-time","description":"Only changes detected after this ISO-8601 instant"},"min_significance":{"type":"integer","maximum":10,"minimum":1,"description":"Keep only changes scored at least this"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"integer"},"source":{"type":"string"},"changes":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"detail":{"type":"object"},"summary":{"type":"string"},"entityId":{"type":"string"},"sourceUrl":{"type":["string","null"],"description":"Primary-source link for verification"},"detectedAt":{"type":"string","format":"date-time"},"significance":{"type":"integer","maximum":10,"minimum":1},"effectiveDate":{"type":["string","null"]}}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7OgQatW55xdru1ZdrGu_e","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns recent USGS earthquakes (M4.5+, past week) with magnitude, location, depth, tsunami flag, and a 1–10 significance score, optionally filtered by significance threshold or detection timestamp.","exampleAgentPrompt":"Pull the latest USGS earthquake data and show me only the high-impact events — anything with a significance score of 8 or above, up to 50 results, detected since 2025-01-01T00:00:00Z.","exampleUseCases":null,"resultDescription":"A JSON object containing a count, a source label, and an array of earthquake change events — each with an entity ID, title, summary, detail object (magnitude, location, depth, tsunami flag), significance score (1–10), detection timestamp, effective date, and a source URL linking to the USGS event page.","failureModes":["Invalid min_significance value outside 1–10 range returns 400 validation error","Invalid since timestamp format returns 400 bad request","limit exceeding 500 returns 400 validation error","Payment not included or insufficient returns 402 Payment Required","No earthquakes matching filters returns empty changes array with count 0","USGS upstream unavailable returns 503 or stale data"],"whenToPreferThis":"Use this endpoint when you need structured, pre-scored earthquake event data from USGS without building your own USGS API integration. Ideal for monitoring significant seismic events (M4.5+) in near-real-time, especially when you want to filter by a significance threshold (e.g. only the most serious events) or poll for new events since a specific timestamp. Prefer over raw USGS APIs when you want normalized change-feed semantics with significance scoring already applied.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:32:04.487Z","isFirstParty":false}