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 explicit one-based offset pagination and an exact to…

USGS_query_earthquakes tool specification

Tool Information:

  • Name: USGS_query_earthquakes

  • Type: BaseRESTTool

  • Description: Query the USGS FDSN earthquake database with explicit one-based offset pagination and an exact total from the official count endpoint. Continue with metadata.next_offset while metadata.has_more is true. The GeoJSON response itself contains only the current page and does not include a total count. Use a fixed endtime for reproducible pagination of live data.

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) Events per page (default 20000, max 20000)

  • offset (integer) (optional) One-based event offset. Continue with metadata.next_offset.

  • orderby (string) (optional) Stable result ordering. Default ‘time’ (newest first).

Example Usage:

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