{"uid":"cap_Qa9svVl4soBVud-Y1T0na","slug":"natur-halowerk-earthquake-brief-d576ed20","name":"Natur Halowerk Earthquake Brief","description":"Returns a single earthquake in decision-ready form, either by its USGS event identifier or as the most significant event matching a search. Magnitude is reported with the magnitude type, because moment magnitude and local magnitude are not interchangeable at the edges of their ranges.","url":"https://natur.halowerk.com/v1/earthquake-brief","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"hours":{"type":"integer","default":24,"maximum":720,"minimum":1,"description":"Search window when no event_id is given."},"event_id":{"type":"string","maxLength":40,"description":"USGS event id, e.g. us7000abcd. Without it the strongest recent event matching the filters is returned."},"min_magnitude":{"type":"number","default":5,"maximum":10,"minimum":0,"description":"Used only when no event_id is given."},"reference_lat":{"type":"number","maximum":90,"minimum":-90,"description":"Your location, to get distance and bearing."},"reference_lon":{"type":"number","maximum":180,"minimum":-180}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_be3JH-Gv0B9iFox_h9A3a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a single earthquake in decision-ready form — by USGS event ID or as the most significant matching event — including magnitude with its type (e.g. Mw, ML)","exampleAgentPrompt":"What was the most significant earthquake in Japan in the past 7 days? Give me the magnitude with its magnitude type, depth, and exact location.","exampleUseCases":[{"title":"Emergency response seismic check","prompt":"There's been a reported earthquake near Los Angeles — can you pull the most significant seismic event within 100 km of LA in the last 6 hours and tell me the magnitude, magnitude type, and depth?"},{"title":"Look up specific USGS earthquake event","prompt":"I have the USGS event ID us7000abcd — can you get me the full decision-ready summary for that earthquake, including magnitude type?"},{"title":"Automated infrastructure risk alert","prompt":"We need to know the strongest earthquake near our data center in Wellington, New Zealand in the past 48 hours — give me the magnitude with the correct magnitude type so we can decide whether to run structural checks."}],"resultDescription":"A single earthquake record in decision-ready form, including the event's magnitude (with its magnitude type such as Mw or ML), geographic location, depth, origin time, and USGS event identifier. The magnitude type is explicitly reported because moment magnitude and local magnitude are not interchangeable at the edges of their ranges.","failureModes":["Event ID not found — returns error if the specified USGS event identifier does not exist or has been removed","No matching event — if search parameters yield no earthquakes, returns an empty or not-found response","Ambiguous search — if search parameters match multiple events, returns only the most significant one (which may not be the intended event)","Stale data — USGS catalog may have slight ingestion delays for very recent events","Invalid parameters — malformed coordinates, dates, or magnitudes return a validation error"],"whenToPreferThis":"Choose this endpoint when you need a single, clean, decision-ready earthquake record — either by exact USGS event ID or as the top event from a search — and when correct magnitude type attribution (Mw vs ML) matters for downstream decisions. Prefer it over raw USGS API calls when you need a pre-digested, agent-friendly response without parsing complex GeoJSON. Less appropriate when you need a list of many earthquakes or want to cluster events (see the sibling clustering endpoint).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:36:11.943Z","isFirstParty":false}