{
  "x402Version": 2,
  "id": 72306,
  "slug": "saylorinnovations-api-space-ephemeris",
  "resource": "https://saylorinnovations.com/api/space/ephemeris",
  "description": "JPL Horizons sky position of the Sun, Moon, planets, Ceres or Vesta - right ascension, declination, apparent magnitude, distance in AU, range rate and elongation",
  "type": "http",
  "serviceName": "Saylor Innovations Data Desk",
  "mimeType": "application/json",
  "resourceType": "API",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:137",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:42161",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "So11111111111111111111111111111111111111112",
      "amount": "95830",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    }
  ],
  "outputSchema": {
    "type": "object",
    "properties": {
      "body": {
        "type": "string",
        "description": "Main body text"
      },
      "observer": {
        "type": "string",
        "description": "Observer location the positions are computed for"
      },
      "start": {
        "type": "string",
        "description": "First date of the table"
      },
      "days": {
        "type": "number",
        "description": "Number of days"
      },
      "now": {
        "type": "object",
        "description": "Position at the first row: right ascension, declination, distance and magnitude"
      },
      "approaching": {
        "type": [
          "boolean",
          "null"
        ],
        "description": "True when the body is getting closer to the observer"
      },
      "ephemeris": {
        "type": "array",
        "description": "Daily positions with RA and Dec in degrees, distance in AU, apparent magnitude and elongation"
      },
      "note": {
        "type": "string",
        "description": "Caveat or context for reading the result"
      },
      "source": {
        "type": "string",
        "description": "Data source the values come from"
      },
      "evening_visible_hint": {
        "type": [
          "string",
          "null"
        ],
        "description": "Evening visible hint"
      }
    },
    "required": [
      "body",
      "now",
      "ephemeris"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "body": "mars",
            "days": "3"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "body": "Mars",
            "observer": "Earth geocenter",
            "start": "2026-10-17",
            "days": 4,
            "now": {
              "date": "2026-Oct-17 00:00",
              "ra_deg": 133.18032,
              "ra_hours": 8.8787,
              "dec_deg": 18.89577,
              "apparent_magnitude": 1.016,
              "surface_brightness": 4.543,
              "distance_au": 1.55009122689896,
              "distance_million_km": 231.89,
              "range_rate_km_s": -13.0795763,
              "elongation_from_sun_deg": 72.9096,
              "light_time_minutes": 12.89
            },
            "approaching": true,
            "evening_visible_hint": "well separated from the Sun, observable",
            "ephemeris": [
              {
                "date": "2026-Oct-17 00:00",
                "ra_deg": 133.18032,
                "ra_hours": 8.8787,
                "dec_deg": 18.89577,
                "apparent_magnitude": 1.016,
                "surface_brightness": 4.543,
                "distance_au": 1.55009122689896,
                "distance_million_km": 231.89,
                "range_rate_km_s": -13.0795763,
                "elongation_from_sun_deg": 72.9096,
                "light_time_minutes": 12.89
              },
              {
                "date": "2026-Oct-18 00:00",
                "ra_deg": 133.73946,
                "ra_hours": 8.916,
                "dec_deg": 18.76489,
                "apparent_magnitude": 0.995,
                "surface_brightness": 4.532,
                "distance_au": 1.5425175893597,
                "distance_million_km": 230.76,
                "range_rate_km_s": -13.1484912,
                "elongation_from_sun_deg": 73.3568,
                "light_time_minutes": 12.83
              },
              {
                "date": "2026-Oct-19 00:00",
                "ra_deg": 134.29516,
                "ra_hours": 8.953,
                "dec_deg": 18.63331,
                "apparent_magnitude": 0.986,
                "surface_brightness": 4.533,
                "distance_au": 1.53490441159291,
                "distance_million_km": 229.62,
                "range_rate_km_s": -13.2165144,
                "elongation_from_sun_deg": 73.8071,
                "light_time_minutes": 12.77
              }
            ],
            "note": "JPL Horizons astrometric positions (ICRF) as seen from Earth's centre; RA in degrees and hours, distance in AU. Negative range rate means the body is getting closer.",
            "source": "NASA JPL Horizons"
          }
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "type": "string",
                "enum": [
                  "GET"
                ]
              },
              "queryParams": {
                "type": "object",
                "properties": {
                  "body": {
                    "type": "string",
                    "description": "sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, ceres or vesta"
                  },
                  "days": {
                    "type": "string",
                    "description": "optional 1-30, default 3"
                  }
                },
                "required": [
                  "body"
                ]
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "body": {
                    "type": "string",
                    "description": "Main body text"
                  },
                  "observer": {
                    "type": "string",
                    "description": "Observer location the positions are computed for"
                  },
                  "start": {
                    "type": "string",
                    "description": "First date of the table"
                  },
                  "days": {
                    "type": "number",
                    "description": "Number of days"
                  },
                  "now": {
                    "type": "object",
                    "description": "Position at the first row: right ascension, declination, distance and magnitude"
                  },
                  "approaching": {
                    "type": [
                      "boolean",
                      "null"
                    ],
                    "description": "True when the body is getting closer to the observer"
                  },
                  "ephemeris": {
                    "type": "array",
                    "description": "Daily positions with RA and Dec in degrees, distance in AU, apparent magnitude and elongation"
                  },
                  "note": {
                    "type": "string",
                    "description": "Caveat or context for reading the result"
                  },
                  "source": {
                    "type": "string",
                    "description": "Data source the values come from"
                  },
                  "evening_visible_hint": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Evening visible hint"
                  }
                },
                "required": [
                  "body",
                  "now",
                  "ephemeris"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "where is mars in the sky right",
    "planet right ascension",
    "distance to jupiter today in au",
    "apparent magnitude of venus",
    "jpl horizons ephemeris"
  ],
  "sourceHost": "saylorinnovations.com",
  "lastUpdated": "2026-10-26T22:14:01.877Z",
  "quality": {},
  "metadata": {
    "serviceName": "Saylor Innovations Data Desk",
    "method": "GET",
    "mimeType": "application/json",
    "inputSchema": {
      "type": "object",
      "properties": {
        "body": {
          "type": "string",
          "description": "sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, ceres or vesta"
        },
        "days": {
          "type": "string",
          "description": "optional 1-30, default 3"
        }
      },
      "required": [
        "body"
      ]
    },
    "exampleResponse": {
      "body": "Mars",
      "observer": "Earth geocenter",
      "start": "2026-10-17",
      "days": 4,
      "now": {
        "date": "2026-Oct-17 00:00",
        "ra_deg": 133.18032,
        "ra_hours": 8.8787,
        "dec_deg": 18.89577,
        "apparent_magnitude": 1.016,
        "surface_brightness": 4.543,
        "distance_au": 1.55009122689896,
        "distance_million_km": 231.89,
        "range_rate_km_s": -13.0795763,
        "elongation_from_sun_deg": 72.9096,
        "light_time_minutes": 12.89
      },
      "approaching": true,
      "evening_visible_hint": "well separated from the Sun, observable",
      "ephemeris": [
        {
          "date": "2026-Oct-17 00:00",
          "ra_deg": 133.18032,
          "ra_hours": 8.8787,
          "dec_deg": 18.89577,
          "apparent_magnitude": 1.016,
          "surface_brightness": 4.543,
          "distance_au": 1.55009122689896,
          "distance_million_km": 231.89,
          "range_rate_km_s": -13.0795763,
          "elongation_from_sun_deg": 72.9096,
          "light_time_minutes": 12.89
        },
        {
          "date": "2026-Oct-18 00:00",
          "ra_deg": 133.73946,
          "ra_hours": 8.916,
          "dec_deg": 18.76489,
          "apparent_magnitude": 0.995,
          "surface_brightness": 4.532,
          "distance_au": 1.5425175893597,
          "distance_million_km": 230.76,
          "range_rate_km_s": -13.1484912,
          "elongation_from_sun_deg": 73.3568,
          "light_time_minutes": 12.83
        },
        {
          "date": "2026-Oct-19 00:00",
          "ra_deg": 134.29516,
          "ra_hours": 8.953,
          "dec_deg": 18.63331,
          "apparent_magnitude": 0.986,
          "surface_brightness": 4.533,
          "distance_au": 1.53490441159291,
          "distance_million_km": 229.62,
          "range_rate_km_s": -13.2165144,
          "elongation_from_sun_deg": 73.8071,
          "light_time_minutes": 12.77
        }
      ],
      "note": "JPL Horizons astrometric positions (ICRF) as seen from Earth's centre; RA in degrees and hours, distance in AU. Negative range rate means the body is getting closer.",
      "source": "NASA JPL Horizons"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "body": "mars",
              "days": "3"
            }
          },
          "output": {
            "type": "json",
            "example": {
              "body": "Mars",
              "observer": "Earth geocenter",
              "start": "2026-10-17",
              "days": 4,
              "now": {
                "date": "2026-Oct-17 00:00",
                "ra_deg": 133.18032,
                "ra_hours": 8.8787,
                "dec_deg": 18.89577,
                "apparent_magnitude": 1.016,
                "surface_brightness": 4.543,
                "distance_au": 1.55009122689896,
                "distance_million_km": 231.89,
                "range_rate_km_s": -13.0795763,
                "elongation_from_sun_deg": 72.9096,
                "light_time_minutes": 12.89
              },
              "approaching": true,
              "evening_visible_hint": "well separated from the Sun, observable",
              "ephemeris": [
                {
                  "date": "2026-Oct-17 00:00",
                  "ra_deg": 133.18032,
                  "ra_hours": 8.8787,
                  "dec_deg": 18.89577,
                  "apparent_magnitude": 1.016,
                  "surface_brightness": 4.543,
                  "distance_au": 1.55009122689896,
                  "distance_million_km": 231.89,
                  "range_rate_km_s": -13.0795763,
                  "elongation_from_sun_deg": 72.9096,
                  "light_time_minutes": 12.89
                },
                {
                  "date": "2026-Oct-18 00:00",
                  "ra_deg": 133.73946,
                  "ra_hours": 8.916,
                  "dec_deg": 18.76489,
                  "apparent_magnitude": 0.995,
                  "surface_brightness": 4.532,
                  "distance_au": 1.5425175893597,
                  "distance_million_km": 230.76,
                  "range_rate_km_s": -13.1484912,
                  "elongation_from_sun_deg": 73.3568,
                  "light_time_minutes": 12.83
                },
                {
                  "date": "2026-Oct-19 00:00",
                  "ra_deg": 134.29516,
                  "ra_hours": 8.953,
                  "dec_deg": 18.63331,
                  "apparent_magnitude": 0.986,
                  "surface_brightness": 4.533,
                  "distance_au": 1.53490441159291,
                  "distance_million_km": 229.62,
                  "range_rate_km_s": -13.2165144,
                  "elongation_from_sun_deg": 73.8071,
                  "light_time_minutes": 12.77
                }
              ],
              "note": "JPL Horizons astrometric positions (ICRF) as seen from Earth's centre; RA in degrees and hours, distance in AU. Negative range rate means the body is getting closer.",
              "source": "NASA JPL Horizons"
            }
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "input": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "http"
                },
                "method": {
                  "type": "string",
                  "enum": [
                    "GET"
                  ]
                },
                "queryParams": {
                  "type": "object",
                  "properties": {
                    "body": {
                      "type": "string",
                      "description": "sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, ceres or vesta"
                    },
                    "days": {
                      "type": "string",
                      "description": "optional 1-30, default 3"
                    }
                  },
                  "required": [
                    "body"
                  ]
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "body": {
                      "type": "string",
                      "description": "Main body text"
                    },
                    "observer": {
                      "type": "string",
                      "description": "Observer location the positions are computed for"
                    },
                    "start": {
                      "type": "string",
                      "description": "First date of the table"
                    },
                    "days": {
                      "type": "number",
                      "description": "Number of days"
                    },
                    "now": {
                      "type": "object",
                      "description": "Position at the first row: right ascension, declination, distance and magnitude"
                    },
                    "approaching": {
                      "type": [
                        "boolean",
                        "null"
                      ],
                      "description": "True when the body is getting closer to the observer"
                    },
                    "ephemeris": {
                      "type": "array",
                      "description": "Daily positions with RA and Dec in degrees, distance in AU, apparent magnitude and elongation"
                    },
                    "note": {
                      "type": "string",
                      "description": "Caveat or context for reading the result"
                    },
                    "source": {
                      "type": "string",
                      "description": "Data source the values come from"
                    },
                    "evening_visible_hint": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Evening visible hint"
                    }
                  },
                  "required": [
                    "body",
                    "now",
                    "ephemeris"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/space/ephemeris?body=mars&days=3",
        "expectedStatus": 402
      }
    ],
    "cacheTtlSeconds": 0,
    "capabilities": [],
    "noAccountRequired": true,
    "noApiKeyRequired": true,
    "sideEffects": "Paid calls settle the advertised payment; see the provider contract for execution behavior.",
    "payment": {
      "protocol": "x402",
      "settlement": "direct-to-provider"
    },
    "provider": {
      "name": "Saylor Innovations",
      "host": "saylorinnovations.com",
      "manifestUrl": "https://saylorinnovations.com/.well-known/x402.json"
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": true,
  "featured": false,
  "provider": {
    "host": "saylorinnovations.com",
    "manifest_name": "Saylor Innovations Knowledge Base",
    "source": "submitted",
    "source_manifest_url": "https://saylorinnovations.com/.well-known/x402.json",
    "submitted_at": "2026-10-26T05:52:02.113Z"
  },
  "exampleResponse": {
    "body": "string",
    "observer": "string",
    "start": "string",
    "days": 0,
    "now": {},
    "approaching": true,
    "ephemeris": [
      "value"
    ],
    "note": "string",
    "source": "string",
    "evening_visible_hint": "string"
  }
}