Nasa Sbdb Tools

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

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

Available Tools

NASASBDB_close_approaches (Type: BaseRESTTool)

Query NASA’s Close Approach Data (CAD) API for asteroids and comets making close approaches to Ea…

NASASBDB_close_approaches tool specification

Tool Information:

  • Name: NASASBDB_close_approaches

  • Type: BaseRESTTool

  • Description: Query NASA’s Close Approach Data (CAD) API for asteroids and comets making close approaches to Earth or other planets. Returns upcoming or historical close approaches with distances, velocities, and object properties. Useful for planetary defense research, monitoring near-Earth objects, and studying asteroid flybys. Distance units: AU (1 AU = 149.6 million km). Minimum distance 0 (impact), typical close approaches < 0.05 AU.

Parameters:

  • dist-max ([‘string’, ‘null’]) (optional) Maximum approach distance in AU. Examples: ‘0.01’ (1.5 million km), ‘0.05’ (7.5 million km), ‘0.5’ (75 million km). Default: 0.05

  • date-min ([‘string’, ‘null’]) (optional) Start date for search (YYYY-MM-DD format). Default: current date.

  • date-max ([‘string’, ‘null’]) (optional) End date for search (YYYY-MM-DD format). Example: ‘2025-12-31’

  • h-max ([‘number’, ‘null’]) (optional) Filter by maximum absolute magnitude H (smaller H = larger object). H<18 is ~1km diameter, H<22 is ~100m diameter.

  • des ([‘string’, ‘null’]) (optional) Filter by specific body designation (e.g., ‘99942’ for Apophis, ‘2020 SO’)

  • limit ([‘integer’, ‘null’]) (optional) Maximum number of results (default 50, max 10000)

Example Usage:

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

NASASBDB_get_body (Type: BaseRESTTool)

Get physical and orbital data for an asteroid, comet, or small solar system body from NASA’s Smal…

NASASBDB_get_body tool specification

Tool Information:

  • Name: NASASBDB_get_body

  • Type: BaseRESTTool

  • Description: Get physical and orbital data for an asteroid, comet, or small solar system body from NASA’s Small Body Database (SBDB). Returns object classification (asteroid/comet type), orbital class (NEO, MBA, Centaur, TNO, etc.), physical parameters (magnitude, size estimates), and detailed orbital elements. SBDB catalogs 1.3 million+ small bodies. Search by name (e.g., ‘Ceres’, ‘Halley’, ‘Apophis’), number (e.g., ‘433’ for Eros), or provisional designation (e.g., ‘2020 SO’).

Parameters:

  • sstr (string) (required) Small body identifier: name, number, or designation. Examples: ‘Ceres’ (1 Ceres), ‘433’ (433 Eros), ‘Apophis’ (99942 Apophis), ‘Bennu’ (101955 Bennu), ‘Halley’ (1P/Halley comet), ‘2020 SO’, ‘67P’ (Churyumov-Gerasimenko)

  • phys-par ([‘string’, ‘null’]) (optional) Whether to include physical parameters: ‘true’ (default) or ‘false’

Example Usage:

query = {
    "name": "NASASBDB_get_body",
    "arguments": {
        "sstr": "example_value"
    }
}
result = tu.run(query)