{"uid":"cap_FTbFlH35j_fpkbz2xPC-l","slug":"foundry-usgs-earthquake-event-set-change-detection-14956fb8","name":"Foundry USGS Earthquake Event Set Change Detection","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-event-set-change","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"window":{"type":"object","required":["latitude","longitude","radius_km","start_time","end_time","minimum_magnitude","limit"],"properties":{"limit":{"type":"integer","default":10,"maximum":20,"minimum":1},"end_time":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"latitude":{"type":"number","maximum":90,"minimum":-90},"longitude":{"type":"number","maximum":180,"minimum":-180},"radius_km":{"type":"number","maximum":2000,"exclusiveMinimum":0},"start_time":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"minimum_magnitude":{"type":"number","default":0,"maximum":10,"minimum":-2}},"additionalProperties":false},"baseline_event_ids":{"type":"array","items":{"type":"string","pattern":"^[a-zA-Z0-9]{1,100}$"},"maxItems":20}}},"responseSchema":{"type":"json","example":{"route":"usgs-event-set-change","result":{"added":[],"current":{"query":{"limit":10,"end_time":"2026-09-06T00:00:00Z","latitude":37.77,"longitude":-122.42,"radius_km":100,"start_time":"2026-09-05T00:00:00Z","minimum_magnitude":0},"events":[],"complete":true,"evidence":{"source":"USGS Earthquake Catalog","license":"US public-domain earthquake facts; no third-party media","terms_url":"https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits","source_url":"https://earthquake.usgs.gov/fdsnws/event/1/query","attribution":"US Geological Survey and the contributing seismic network identified in each record","retrieved_at":"2026-09-06T00:00:00Z","upstream_calls":1,"cache_age_seconds":0,"source_generated_at":null},"limitations":["Reported seismic observations may be revised; no emergency warning or impact prediction.","Complete means the bounded source query was not truncated at retrieval; it does not guarantee all earthquakes are catalogued.","Synthetic empty result only; no live observation claimed."],"observed_at":"2026-09-06T00:00:00Z"},"retained":[],"limitations":["Synthetic example; absence from a query does not establish deletion."],"observed_at":"2026-09-06T00:00:00Z","unresolved_absence":[],"not_in_current_query":["us7000m9g4"]},"observed_at":"2026-09-06T00:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.011","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.011/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.011","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.011","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3W1LZqD7qjAqEGgtRD4Dp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.011","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares a set of known USGS earthquake event IDs against a fresh bounded query to identify added, retained, and absent events within a geographic window and time range.","exampleAgentPrompt":"Check the USGS earthquake catalog for any new or changed events within 150 km of San Francisco (37.77, -122.42) between 2026-09-05T00:00:00Z and 2026-09-06T00:00:00Z with minimum magnitude 2.5, and compare against my baseline event IDs ['us7000m9g4', 'us7000m9g5'] — show me what was added, retained, or is missing.","exampleUseCases":[{"title":"Nightly seismic change alert pipeline","prompt":"Every morning I want to know if any new earthquakes above magnitude 3.0 appeared near Tokyo (35.69, 139.69) within 200 km over the past 24 hours that weren't in yesterday's list — my baseline IDs are ['pt24250001','pt24250002']. Give me the added and missing events."},{"title":"Post-event catalog revision audit","prompt":"I recorded earthquake event 'us7000abc1' near Anchorage (61.22, -149.90) within 300 km last week. Can you check if it's still in the USGS catalog for the window 2026-08-01T00:00:00Z to 2026-08-08T00:00:00Z, minimum magnitude 0, and tell me if it was retained, dropped, or if anything new was added?"},{"title":"Research baseline reconciliation","prompt":"I have a list of 5 USGS earthquake IDs from a study near Ridgecrest CA (35.63, -117.67) within 100 km between 2026-07-01T00:00:00Z and 2026-07-31T00:00:00Z — IDs are ['ci39645386','ci39645400','ci39645412','ci39645430','ci39645450']. Show me which ones are still in the catalog, which disappeared, and if any new ones above magnitude 1.0 appeared."}],"resultDescription":"A JSON object containing: 'added' (events now in USGS query but not in baseline), 'retained' (events present in both baseline and current query), 'unresolved_absence' (baseline IDs not explained by current query), 'not_in_current_query' (baseline IDs outside the current query window), and 'current' (the full current event set with query parameters, event list, completeness flag, evidence provenance including source URL, license, attribution, retrieval timestamp, and upstream call count). Includes limitations disclaimers about catalog revision and completeness.","failureModes":["Invalid datetime format (must be ISO 8601 UTC with Z suffix) returns validation error","radius_km exceeding 2000 or being zero/negative returns schema error","limit outside 1-20 range returns validation error","latitude/longitude out of bounds returns validation error","baseline_event_ids array exceeding 20 items rejected","USGS upstream unavailability may cause retrieval failure","Empty result set returned if no earthquakes match the window — not an error"],"whenToPreferThis":"Use this endpoint when you need to detect changes in the USGS earthquake catalog over time — specifically to identify newly catalogued events, verify that previously known events are still present, or flag events that have been revised or removed. It is the right choice when you have a prior baseline of USGS event IDs and want a structured diff against a fresh bounded query. Prefer over a plain earthquake lookup when change detection, reconciliation, or provenance-backed evidence is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:54:54.237Z","isFirstParty":false}