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/JPL Close Approach Data with explicit zero-based offset pagination and exact total met…

NASASBDB_close_approaches tool specification

Tool Information:

  • Name: NASASBDB_close_approaches

  • Type: BaseRESTTool

  • Description: Query NASA/JPL Close Approach Data with explicit zero-based offset pagination and exact total metadata. Continue with metadata.next_offset while metadata.has_more is true. Results default to date order for stable traversal. Distance units are AU (1 AU = 149.6 million km).

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) Close approaches per page (default 50, max 10000)

  • offset (integer) (optional) Zero-based result offset, mapped to JPL’s limit-from. Continue with metadata.next_offset.

  • sort (string) (optional) JPL CAD sort expression. Default ‘date’ for chronological traversal.

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)