{"uid":"cap_sCnJjoyh17C_OuhkZ2UTu","slug":"foundry-usgs-asset-incident-composite-ec4cf2d9","name":"Foundry USGS Asset-Incident Composite","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-asset-incident-composite","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":20,"maximum":20,"minimum":1},"assets":{"type":"array","items":{"type":"object","required":["id","latitude","longitude"],"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,40}$"},"latitude":{"type":"number","maximum":90,"minimum":-90},"longitude":{"type":"number","maximum":180,"minimum":-180}},"additionalProperties":false},"maxItems":5,"minItems":2},"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))$"},"radius_km":{"type":"number","maximum":500,"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}}},"responseSchema":{"type":"json","example":{"route":"usgs-asset-incident-composite","result":{"pairs":[],"assets":[{"id":"warehouse-a","latitude":37.77,"longitude":-122.42},{"id":"warehouse-b","latitude":37.33,"longitude":-121.89}],"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"},"radius_km":100,"limitations":["Synthetic empty example; no actual asset exposure observation."],"observed_at":"2026-09-06T00:00:00Z","asset_summaries":[{"status":"NONE_OBSERVED_COMPLETE","asset_id":"warehouse-a","matched_events":0,"pair_list_complete":true},{"status":"NONE_OBSERVED_COMPLETE","asset_id":"warehouse-b","matched_events":0,"pair_list_complete":true}],"distance_method":"SPHERICAL_HAVERSINE_R6371.0088_KM","unlocated_event_ids":[]},"observed_at":"2026-09-06T00:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.009","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.009/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gngh6ei7YNPANu1Lnv7oO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.009","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"For a set of geographic asset locations, queries USGS earthquake catalog data within a given radius and time window and returns which seismic events are near each asset.","exampleAgentPrompt":"Check if any earthquakes of magnitude 3.0 or greater were recorded within 200km of my two warehouses — warehouse-alpha at 37.77°N, 122.42°W and warehouse-beta at 37.33°N, 121.89°W — between 2024-01-01T00:00:00Z and 2024-01-31T23:59:59Z, and tell me how many events matched each site.","exampleUseCases":[{"title":"Post-earthquake facility exposure check","prompt":"We just heard about seismic activity in Northern California — can you check the USGS catalog for any earthquakes magnitude 2.5 or above within 150km of our three distribution centers at 37.77°N/-122.42°W, 37.33°N/-121.89°W, and 36.97°N/-122.02°W between 2024-03-15T00:00:00Z and 2024-03-16T23:59:59Z?"},{"title":"Weekly seismic risk summary for assets","prompt":"Pull this week's USGS earthquake data — from 2024-06-10T00:00:00Z to 2024-06-17T00:00:00Z — for our two monitored sites: site-A at 34.05°N/-118.24°W and site-B at 33.75°N/-118.00°W, within a 100km radius, any magnitude, and show me how many events matched each location."},{"title":"Insurance underwriting seismic exposure audit","prompt":"I need official USGS earthquake records from 2023-01-01T00:00:00Z to 2023-12-31T23:59:59Z for two properties we're underwriting — property-1 at 38.58°N/-121.49°W and property-2 at 37.87°N/-122.27°W — within 250km, minimum magnitude 1.0, up to 20 results, so I can document seismic exposure for the insurer."}],"resultDescription":"A JSON object containing: the list of input assets with their coordinates; per-asset summaries (matched event count, completeness status); asset-event pairs listing which specific earthquakes were near each asset; the raw USGS query parameters used; source evidence metadata (source name, license, terms URL, retrieval timestamp, cache age); and a set of limitations disclaimers about data completeness and no emergency/safety guarantees.","failureModes":["Invalid datetime format in start_time or end_time returns a validation error","radius_km of 0 or negative is rejected (exclusiveMinimum: 0)","Fewer than 2 or more than 5 assets in the assets array causes a schema validation error","Asset ID not matching pattern ^[A-Za-z0-9_-]{1,40}$ is rejected","latitude/longitude values outside valid range (-90 to 90, -180 to 180) are rejected","limit exceeding 20 is clamped or rejected","Payment failure (insufficient USDC) returns HTTP 402","USGS upstream unavailability may cause incomplete results flagged in the response"],"whenToPreferThis":"Use this endpoint when you need to correlate multiple named geographic asset locations against the official USGS earthquake catalog for a bounded time window, and you want per-asset match summaries with full source provenance. Prefer it over generic earthquake APIs when you need explicit evidence metadata, source attribution, and asset-incident pairing in a single call. It is particularly well-suited for risk assessment, insurance, facility management, and compliance workflows that require auditable, official seismic records rather than third-party aggregations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:47:16.655Z","isFirstParty":false}