{"openapi":"3.1.0","info":{"title":"ToolMint USGS Earthquakes JSON","version":"0.1.0","description":"USGS FDSN/GeoJSON earthquakes normalized for AI agents — point+radius, bbox, near-me, feeds. Pay per call with USDC on Base via x402. Public domain.","x-guidance":"Use GET /query or /quakes with lat&lon&radiusKm OR minLat&maxLat&minLon&maxLon. Prefer /quakes/near for a 7-day local summary. Unpaid → HTTP 402. Free: /, /health, /openapi.json, /.well-known/x402.","contact":{"email":"toolmint.dev@gmail.com","name":"ToolMint"}},"paths":{"/health":{"get":{"operationId":"health","summary":"Liveness","security":[],"responses":{"200":{"description":"ok"}}}},"/query":{"get":{"operationId":"usgs_query","summary":"Query USGS earthquakes (point+radius, bbox, or global by minMagnitude/startTime)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5","asset":"USDC","scheme":"exact","amountAtomic":"10000"},"parameters":[{"name":"lat","in":"query","schema":{"type":"number"}},{"name":"lon","in":"query","schema":{"type":"number"}},{"name":"radiusKm","in":"query","schema":{"type":"number","default":100}},{"name":"minLat","in":"query","schema":{"type":"number"}},{"name":"maxLat","in":"query","schema":{"type":"number"}},{"name":"minLon","in":"query","schema":{"type":"number"}},{"name":"maxLon","in":"query","schema":{"type":"number"}},{"name":"minMagnitude","in":"query","schema":{"type":"number"}},{"name":"startTime","in":"query","schema":{"type":"string"}},{"name":"endTime","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25}}],"responses":{"200":{"description":"OK (count may be 0 when no events match)"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"502":{"description":"USGS upstream error (not charged)"}}}},"/quakes":{"get":{"operationId":"usgs_quakes","summary":"Alias of /query","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5","asset":"USDC","scheme":"exact","amountAtomic":"10000"},"parameters":[{"name":"lat","in":"query","schema":{"type":"number"}},{"name":"lon","in":"query","schema":{"type":"number"}},{"name":"radiusKm","in":"query","schema":{"type":"number","default":100}},{"name":"minLat","in":"query","schema":{"type":"number"}},{"name":"maxLat","in":"query","schema":{"type":"number"}},{"name":"minLon","in":"query","schema":{"type":"number"}},{"name":"maxLon","in":"query","schema":{"type":"number"}},{"name":"minMagnitude","in":"query","schema":{"type":"number"}},{"name":"startTime","in":"query","schema":{"type":"string"}},{"name":"endTime","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25}}],"responses":{"200":{"description":"OK (count may be 0 when no events match)"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"502":{"description":"USGS upstream error (not charged)"}}}},"/earthquakes":{"get":{"operationId":"usgs_earthquakes","summary":"Alias of /query","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5","asset":"USDC","scheme":"exact","amountAtomic":"10000"},"parameters":[{"name":"lat","in":"query","schema":{"type":"number"}},{"name":"lon","in":"query","schema":{"type":"number"}},{"name":"radiusKm","in":"query","schema":{"type":"number","default":100}},{"name":"minLat","in":"query","schema":{"type":"number"}},{"name":"maxLat","in":"query","schema":{"type":"number"}},{"name":"minLon","in":"query","schema":{"type":"number"}},{"name":"maxLon","in":"query","schema":{"type":"number"}},{"name":"minMagnitude","in":"query","schema":{"type":"number"}},{"name":"startTime","in":"query","schema":{"type":"string"}},{"name":"endTime","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25}}],"responses":{"200":{"description":"OK (count may be 0 when no events match)"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"502":{"description":"USGS upstream error (not charged)"}}}},"/quakes/bbox":{"get":{"operationId":"usgs_bbox","summary":"Alias of /query (bbox)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5","asset":"USDC","scheme":"exact","amountAtomic":"10000"},"parameters":[{"name":"lat","in":"query","schema":{"type":"number"}},{"name":"lon","in":"query","schema":{"type":"number"}},{"name":"radiusKm","in":"query","schema":{"type":"number","default":100}},{"name":"minLat","in":"query","schema":{"type":"number"}},{"name":"maxLat","in":"query","schema":{"type":"number"}},{"name":"minLon","in":"query","schema":{"type":"number"}},{"name":"maxLon","in":"query","schema":{"type":"number"}},{"name":"minMagnitude","in":"query","schema":{"type":"number"}},{"name":"startTime","in":"query","schema":{"type":"string"}},{"name":"endTime","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25}}],"responses":{"200":{"description":"OK (count may be 0 when no events match)"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"502":{"description":"USGS upstream error (not charged)"}}}},"/quakes/radius":{"get":{"operationId":"usgs_radius","summary":"Alias of /query (point+radius)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5","asset":"USDC","scheme":"exact","amountAtomic":"10000"},"parameters":[{"name":"lat","in":"query","schema":{"type":"number"}},{"name":"lon","in":"query","schema":{"type":"number"}},{"name":"radiusKm","in":"query","schema":{"type":"number","default":100}},{"name":"minLat","in":"query","schema":{"type":"number"}},{"name":"maxLat","in":"query","schema":{"type":"number"}},{"name":"minLon","in":"query","schema":{"type":"number"}},{"name":"maxLon","in":"query","schema":{"type":"number"}},{"name":"minMagnitude","in":"query","schema":{"type":"number"}},{"name":"startTime","in":"query","schema":{"type":"string"}},{"name":"endTime","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25}}],"responses":{"200":{"description":"OK (count may be 0 when no events match)"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"502":{"description":"USGS upstream error (not charged)"}}}},"/quakes/near":{"get":{"operationId":"usgs_near","summary":"Near-me 7-day summary","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5","asset":"USDC","scheme":"exact","amountAtomic":"10000"},"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number"}},{"name":"lon","in":"query","required":true,"schema":{"type":"number"}},{"name":"radiusKm","in":"query","schema":{"type":"number","default":200}},{"name":"minMagnitude","in":"query","schema":{"type":"number","default":2.5}},{"name":"limit","in":"query","schema":{"type":"integer","default":25}}],"responses":{"200":{"description":"OK (count may be 0 when no events match)"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"502":{"description":"USGS upstream error (not charged)"}}}},"/near":{"get":{"operationId":"usgs_near_alias","summary":"Alias of /quakes/near","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5","asset":"USDC","scheme":"exact","amountAtomic":"10000"},"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number"}},{"name":"lon","in":"query","required":true,"schema":{"type":"number"}},{"name":"radiusKm","in":"query","schema":{"type":"number","default":200}},{"name":"minMagnitude","in":"query","schema":{"type":"number","default":2.5}},{"name":"limit","in":"query","schema":{"type":"integer","default":25}}],"responses":{"200":{"description":"OK (count may be 0 when no events match)"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"502":{"description":"USGS upstream error (not charged)"}}}},"/quakes/feed":{"get":{"operationId":"usgs_feed","summary":"USGS summary feed","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5","asset":"USDC","scheme":"exact","amountAtomic":"10000"},"parameters":[{"name":"feed","in":"query","required":true,"schema":{"type":"string","enum":["all_hour","all_day","all_week","all_month","significant_hour","significant_day","significant_week","significant_month","4.5_day","4.5_week","2.5_day","2.5_week","1.0_day","1.0_week"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":25}}],"responses":{"200":{"description":"OK (count may be 0 when no events match)"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"502":{"description":"USGS upstream error (not charged)"}}}},"/feed":{"get":{"operationId":"usgs_feed_alias","summary":"Alias of /quakes/feed","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5","asset":"USDC","scheme":"exact","amountAtomic":"10000"},"parameters":[{"name":"feed","in":"query","required":true,"schema":{"type":"string","enum":["all_hour","all_day","all_week","all_month","significant_hour","significant_day","significant_week","significant_month","4.5_day","4.5_week","2.5_day","2.5_week","1.0_day","1.0_week"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":25}}],"responses":{"200":{"description":"OK (count may be 0 when no events match)"},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment Required"},"502":{"description":"USGS upstream error (not charged)"}}}}}}