Usgs Earthquake Tools

Configuration File: usgs_earthquake_tools.json Tool Type: Local Tools Count: 2

This page contains all tools defined in the usgs_earthquake_tools.json configuration file.

Available Tools

USGS_get_earthquake_feed (Type: BaseRESTTool)

Get recent USGS earthquake data feeds in GeoJSON format. Returns earthquakes based on magnitude t…

USGS_get_earthquake_feed tool specification

Tool Information:

  • Name: USGS_get_earthquake_feed

  • Type: BaseRESTTool

  • Description: Get recent USGS earthquake data feeds in GeoJSON format. Returns earthquakes based on magnitude threshold and time period. Data includes magnitude, location, depth, coordinates, and impact metrics. Feeds are updated in real-time. Use for monitoring seismic activity, disaster response planning, and geological research.

Parameters:

  • magnitude (string) (required) Minimum magnitude filter: ‘significant’ (felt widely), ‘4.5’, ‘2.5’, ‘1.0’, ‘all’ (includes micro-earthquakes). Higher magnitude = fewer but larger events.

  • period (string) (required) Time period: ‘hour’ (past 1 hour), ‘day’ (past 24 hours), ‘week’ (past 7 days), ‘month’ (past 30 days)

Example Usage:

query = {
    "name": "USGS_get_earthquake_feed",
    "arguments": {
        "magnitude": "example_value",
        "period": "example_value"
    }
}
result = tu.run(query)

USGS_query_earthquakes (Type: BaseRESTTool)

Query the USGS FDSN earthquake database with custom parameters to search historical and recent se…

USGS_query_earthquakes tool specification

Tool Information:

  • Name: USGS_query_earthquakes

  • Type: BaseRESTTool

  • Description: Query the USGS FDSN earthquake database with custom parameters to search historical and recent seismic events. Filter by magnitude, time range, location (bounding box or radial search), and depth. Returns detailed GeoJSON for all matching earthquakes. Useful for historical seismicity analysis, regional earthquake studies, and risk assessment.

Parameters:

  • minmagnitude ([‘number’, ‘null’]) (optional) Minimum earthquake magnitude (e.g., 5.0, 6.5, 7.0)

  • maxmagnitude ([‘number’, ‘null’]) (optional) Maximum earthquake magnitude

  • starttime ([‘string’, ‘null’]) (optional) Start time in ISO 8601 format (e.g., ‘2024-01-01’, ‘2020-01-01T00:00:00’)

  • endtime ([‘string’, ‘null’]) (optional) End time in ISO 8601 format (e.g., ‘2024-12-31’). Defaults to current time.

  • minlatitude ([‘number’, ‘null’]) (optional) Minimum latitude for bounding box search (-90 to 90)

  • maxlatitude ([‘number’, ‘null’]) (optional) Maximum latitude for bounding box search

  • minlongitude ([‘number’, ‘null’]) (optional) Minimum longitude (-180 to 360)

  • maxlongitude ([‘number’, ‘null’]) (optional) Maximum longitude

  • limit ([‘integer’, ‘null’]) (optional) Maximum number of events (default 20000, max 20000)

Example Usage:

query = {
    "name": "USGS_query_earthquakes",
    "arguments": {
    }
}
result = tu.run(query)