<!-- generated by scripts/docs/generate-reference.ts — do not edit -->

astro_render_ephemeris

Ephemeris renders — table (Free⌃ text / Paid SVG), circular, graphic-with-overlay, declination-axis graphic.

  • Layer: render
  • Methods: table, circular, graphic, graphic-declination
  • Free tier: table
  • Paid tier: circular, graphic, graphic-declination

Description

Ephemeris renders — table (Free⌃ text / Paid SVG), circular, graphic-with-overlay, declination-axis graphic.

Methods:
  table               [Free] — linear ephemeris table (text Free⌃ / SVG Paid) of body positions over a month
  circular            [Paid] — annual-wheel radial SVG tracing each body's longitude across a date range
  graphic             [Paid] — longitude mod-modulus line plot of body positions with optional structured overlay
  graphic-declination [Paid] — signed-declination line plot over a date range with out-of-bounds bands beyond ±23.44°

Input schema

table

FieldTypeRequiredConstraints
yearintegeryesmin 1800, max 2100, int
monthintegeryesmin 1, max 12, int
tableTypeenum(13)no
zodiacenum(35)no
precision"deg_min" | "deg_only" | "abs_deg"no
trueNodebooleanno
trueLilithbooleanno
customAyanamsa.t0numberyes
customAyanamsa.ayanT0numberyesmin -360, max 360
midpointsarray<string>no

Example request

{
  "method": "table",
  "year": 2024,
  "month": 3
}

Example response (captured; long values elided)

{
  "tableType": "longitude",
  "year": 2024,
  "month": 3,
  "zodiac": "tropical",
  "precision": "deg_min",
  "ayanamsaOffset": null,
  "rows": [
    {
      "date": "2024-03-01",
      "dayOfWeek": "Fri",
      "siderealTime": "10:37:10",
      "obliquity": null,
      "bodies": [
        {
          "id": "Sun",
          "longitude": 340.88949,
          "latitude": -0.000114,
          "speed": 1.003613,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 10,
            "minutes": 53,
            "seconds": 22
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Moon",
          "longitude": 220.482174,
          "latitude": -2.165963,
          "speed": 12.1498,
          "isRetrograde": false,
          "sign": {
            "sign": 7,
            "signName": "Scorpio",
            "degrees": 10,
            "minutes": 28,
            "seconds": 56
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mercury",
          "longitude": 342.324449,
          "latitude": -1.701595,
          "speed": 1.891868,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 12,
            "minutes": 19,
            "seconds": 28
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Venus",
          "longitude": 316.493026,
          "latitude": -0.704157,
          "speed": 1.237824,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 16,
            "minutes": 29,
            "seconds": 35
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mars",
          "longitude": 312.91715,
          "latitude": -1.063207,
          "speed": 0.774371,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 12,
            "minutes": 55,
            "seconds": 2
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Jupiter",
          "longitude": 41.314182,
          "latitude": -0.914569,
          "speed": 0.170615,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 11,
            "minutes": 18,
            "seconds": 51
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Saturn",
          "longitude": 339.913166,
          "latitude": -1.621539,
          "speed": 0.122136,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 9,
            "minutes": 54,
            "seconds": 47
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Uranus",
          "longitude": 49.579206,
          "latitude": -0.282854,
          "speed": 0.028424,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 19,
            "minutes": 34,
            "seconds": 45
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        "… 5 more items"
      ]
    },
    {
      "date": "2024-03-02",
      "dayOfWeek": "Sat",
      "siderealTime": "10:41:06",
      "obliquity": null,
      "bodies": [
        {
          "id": "Sun",
          "longitude": 341.892898,
          "latitude": -0.000145,
          "speed": 1.003203,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 11,
            "minutes": 53,
            "seconds": 34
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Moon",
          "longitude": 232.749923,
          "latitude": -3.126392,
          "speed": 12.398127,
          "isRetrograde": false,
          "sign": {
            "sign": 7,
            "signName": "Scorpio",
            "degrees": 22,
            "minutes": 44,
            "seconds": 60
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mercury",
          "longitude": 344.222785,
          "latitude": -1.612699,
          "speed": 1.904627,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 14,
            "minutes": 13,
            "seconds": 22
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Venus",
          "longitude": 317.730889,
          "latitude": -0.742788,
          "speed": 1.237905,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 17,
            "minutes": 43,
            "seconds": 51
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mars",
          "longitude": 313.691691,
          "latitude": -1.06985,
          "speed": 0.774711,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 13,
            "minutes": 41,
            "seconds": 30
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Jupiter",
          "longitude": 41.485732,
          "latitude": -0.911025,
          "speed": 0.172481,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 11,
            "minutes": 29,
            "seconds": 9
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Saturn",
          "longitude": 340.03531,
          "latitude": -1.62242,
          "speed": 0.122145,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 10,
            "minutes": 2,
            "seconds": 7
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Uranus",
          "longitude": 49.608016,
          "latitude": -0.282489,
          "speed": 0.029196,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 19,
            "minutes": 36,
            "seconds": 29
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        "… 5 more items"
      ]
    },
    {
      "date": "2024-03-03",
      "dayOfWeek": "Sun",
      "siderealTime": "10:45:03",
      "obliquity": null,
      "bodies": [
        {
          "id": "Sun",
          "longitude": 342.895896,
          "latitude": -0.000171,
          "speed": 1.002795,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 12,
            "minutes": 53,
            "seconds": 45
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Moon",
          "longitude": 245.303521,
          "latitude": -3.960722,
          "speed": 12.721363,
          "isRetrograde": false,
          "sign": {
            "sign": 8,
            "signName": "Sagittarius",
            "degrees": 5,
            "minutes": 18,
            "seconds": 13
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mercury",
          "longitude": 346.13327,
          "latitude": -1.514264,
          "speed": 1.916115,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 16,
            "minutes": 7,
            "seconds": 60
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Venus",
          "longitude": 318.968831,
          "latitude": -0.780642,
          "speed": 1.23798,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 18,
            "minutes": 58,
            "seconds": 8
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mars",
          "longitude": 314.466568,
          "latitude": -1.076402,
          "speed": 0.775041,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 14,
            "minutes": 27,
            "seconds": 60
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Jupiter",
          "longitude": 41.659134,
          "latitude": -0.907515,
          "speed": 0.174319,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 11,
            "minutes": 39,
            "seconds": 33
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Saturn",
          "longitude": 340.157446,
          "latitude": -1.623348,
          "speed": 0.122123,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 10,
            "minutes": 9,
            "seconds": 27
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Uranus",
          "longitude": 49.637595,
          "latitude": -0.282127,
          "speed": 0.029961,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 19,
            "minutes": 38,
            "seconds": 15
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        "… 5 more items"
      ]
    },
    {
      "date": "2024-03-04",
      "dayOfWeek": "Mon",
      "siderealTime": "10:48:59",
      "obliquity": null,
      "bodies": [
        {
          "id": "Sun",
          "longitude": 343.898486,
          "latitude": -0.000191,
          "speed": 1.002385,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 13,
            "minutes": 53,
            "seconds": 55
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Moon",
          "longitude": 258.216039,
          "latitude": -4.62062,
          "speed": 13.114358,
          "isRetrograde": false,
          "sign": {
            "sign": 8,
            "signName": "Sagittarius",
            "degrees": 18,
            "minutes": 12,
            "seconds": 58
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mercury",
          "longitude": 348.054472,
          "latitude": -1.406155,
          "speed": 1.925999,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 18,
            "minutes": 3,
            "seconds": 16
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Venus",
          "longitude": 320.206843,
          "latitude": -0.817696,
          "speed": 1.238045,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 20,
            "minutes": 12,
            "seconds": 25
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mars",
          "longitude": 315.241769,
          "latitude": -1.082862,
          "speed": 0.775357,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 15,
            "minutes": 14,
            "seconds": 30
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Jupiter",
          "longitude": 41.83436,
          "latitude": -0.904039,
          "speed": 0.176127,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 11,
            "minutes": 50,
            "seconds": 4
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Saturn",
          "longitude": 340.279548,
          "latitude": -1.62432,
          "speed": 0.122077,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 10,
            "minutes": 16,
            "seconds": 46
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Uranus",
          "longitude": 49.667935,
          "latitude": -0.281766,
          "speed": 0.030717,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 19,
            "minutes": 40,
            "seconds": 5
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        "… 5 more items"
      ]
    },
    {
      "date": "2024-03-05",
      "dayOfWeek": "Tue",
      "siderealTime": "10:52:56",
      "obliquity": null,
      "bodies": [
        {
          "id": "Sun",
          "longitude": 344.900662,
          "latitude": -0.000203,
          "speed": 1.001966,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 14,
            "minutes": 54,
            "seconds": 2
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Moon",
          "longitude": 271.550428,
          "latitude": -5.056527,
          "speed": 13.561518,
          "isRetrograde": false,
          "sign": {
            "sign": 9,
            "signName": "Capricorn",
            "degrees": 1,
            "minutes": 33,
            "seconds": 2
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mercury",
          "longitude": 349.984597,
          "latitude": -1.288276,
          "speed": 1.933897,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 19,
            "minutes": 59,
            "seconds": 5
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Venus",
          "longitude": 321.444914,
          "latitude": -0.853928,
          "speed": 1.238095,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 21,
            "minutes": 26,
            "seconds": 42
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mars",
          "longitude": 316.017276,
          "latitude": -1.089228,
          "speed": 0.775655,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 16,
            "minutes": 1,
            "seconds": 2
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Jupiter",
          "longitude": 42.011378,
          "latitude": -0.900596,
          "speed": 0.177903,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 12,
            "minutes": 0,
            "seconds": 41
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Saturn",
          "longitude": 340.401592,
          "latitude": -1.625332,
          "speed": 0.122007,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 10,
            "minutes": 24,
            "seconds": 6
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Uranus",
          "longitude": 49.699026,
          "latitude": -0.281407,
          "speed": 0.031462,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 19,
            "minutes": 41,
            "seconds": 56
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        "… 5 more items"
      ]
    },
    {
      "date": "2024-03-06",
      "dayOfWeek": "Wed",
      "siderealTime": "10:56:53",
      "obliquity": null,
      "bodies": [
        {
          "id": "Sun",
          "longitude": 345.902412,
          "latitude": -0.000207,
          "speed": 1.001533,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 15,
            "minutes": 54,
            "seconds": 9
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Moon",
          "longitude": 285.347713,
          "latitude": -5.220862,
          "speed": 14.034279,
          "isRetrograde": false,
          "sign": {
            "sign": 9,
            "signName": "Capricorn",
            "degrees": 15,
            "minutes": 20,
            "seconds": 52
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mercury",
          "longitude": 351.921449,
          "latitude": -1.160584,
          "speed": 1.939376,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 21,
            "minutes": 55,
            "seconds": 17
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Venus",
          "longitude": 322.683025,
          "latitude": -0.889319,
          "speed": 1.238126,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 22,
            "minutes": 40,
            "seconds": 59
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mars",
          "longitude": 316.793069,
          "latitude": -1.095498,
          "speed": 0.775929,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 16,
            "minutes": 47,
            "seconds": 35
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Jupiter",
          "longitude": 42.190154,
          "latitude": -0.897187,
          "speed": 0.179643,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 12,
            "minutes": 11,
            "seconds": 25
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Saturn",
          "longitude": 340.523553,
          "latitude": -1.626384,
          "speed": 0.12191,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 10,
            "minutes": 31,
            "seconds": 25
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Uranus",
          "longitude": 49.730854,
          "latitude": -0.28105,
          "speed": 0.032192,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 19,
            "minutes": 43,
            "seconds": 51
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        "… 5 more items"
      ]
    },
    {
      "date": "2024-03-07",
      "dayOfWeek": "Thu",
      "siderealTime": "11:00:49",
      "obliquity": null,
      "bodies": [
        {
          "id": "Sun",
          "longitude": 346.903719,
          "latitude": -0.000201,
          "speed": 1.001079,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 16,
            "minutes": 54,
            "seconds": 13
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Moon",
          "longitude": 299.613586,
          "latitude": -5.074515,
          "speed": 14.490757,
          "isRetrograde": false,
          "sign": {
            "sign": 9,
            "signName": "Capricorn",
            "degrees": 29,
            "minutes": 36,
            "seconds": 49
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mercury",
          "longitude": 353.862371,
          "latitude": -1.023101,
          "speed": 1.941951,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 23,
            "minutes": 51,
            "seconds": 45
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Venus",
          "longitude": 323.921156,
          "latitude": -0.92385,
          "speed": 1.238134,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 23,
            "minutes": 55,
            "seconds": 16
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mars",
          "longitude": 317.569123,
          "latitude": -1.101672,
          "speed": 0.776175,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 17,
            "minutes": 34,
            "seconds": 9
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Jupiter",
          "longitude": 42.370651,
          "latitude": -0.89381,
          "speed": 0.181345,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 12,
            "minutes": 22,
            "seconds": 14
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Saturn",
          "longitude": 340.645403,
          "latitude": -1.627474,
          "speed": 0.121785,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 10,
            "minutes": 38,
            "seconds": 43
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Uranus",
          "longitude": 49.763405,
          "latitude": -0.280695,
          "speed": 0.032906,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 19,
            "minutes": 45,
            "seconds": 48
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        "… 5 more items"
      ]
    },
    {
      "date": "2024-03-08",
      "dayOfWeek": "Fri",
      "siderealTime": "11:04:46",
      "obliquity": null,
      "bodies": [
        {
          "id": "Sun",
          "longitude": 347.90456,
          "latitude": -0.000186,
          "speed": 1.000601,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 17,
            "minutes": 54,
            "seconds": 16
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Moon",
          "longitude": 314.306589,
          "latitude": -4.596641,
          "speed": 14.879615,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 14,
            "minutes": 18,
            "seconds": 24
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mercury",
          "longitude": 355.804197,
          "latitude": -0.875924,
          "speed": 1.941093,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 25,
            "minutes": 48,
            "seconds": 15
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Venus",
          "longitude": 325.159281,
          "latitude": -0.957501,
          "speed": 1.238116,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 25,
            "minutes": 9,
            "seconds": 33
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Mars",
          "longitude": 318.34541,
          "latitude": -1.107748,
          "speed": 0.776394,
          "isRetrograde": false,
          "sign": {
            "sign": 10,
            "signName": "Aquarius",
            "degrees": 18,
            "minutes": 20,
            "seconds": 43
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Jupiter",
          "longitude": 42.552831,
          "latitude": -0.890467,
          "speed": 0.183011,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 12,
            "minutes": 33,
            "seconds": 10
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Saturn",
          "longitude": 340.767112,
          "latitude": -1.628602,
          "speed": 0.121631,
          "isRetrograde": false,
          "sign": {
            "sign": 11,
            "signName": "Pisces",
            "degrees": 10,
            "minutes": 46,
            "seconds": 2
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        {
          "id": "Uranus",
          "longitude": 49.796661,
          "latitude": -0.280342,
          "speed": 0.033605,
          "isRetrograde": false,
          "sign": {
            "sign": 1,
            "signName": "Taurus",
            "degrees": 19,
            "minutes": 47,
            "seconds": 48
          },
          "declination": null,
          "ra": null,
          "isOutOfBounds": false
        },
        "… 5 more items"
      ]
    },
    "… 23 more items"
  ],
  "deltas": [
    {
      "id": "Sun",
      "delta": -330.124288
    },
    {
      "id": "Moon",
      "delta": 34.330868
    },
    {
      "id": "Mercury",
      "delta": -315.329124
    },
    {
      "id": "Venus",
      "delta": 37.120803
    },
    {
      "id": "Mars",
      "delta": 23.315326
    },
    {
      "id": "Jupiter",
      "delta": 5.825227
    },
    {
      "id": "Saturn",
      "delta": 3.572953
    },
    {
      "id": "Uranus",
      "delta": 1.158828
    },
    "… 5 more items"
  ]
}

circular

FieldTypeRequiredConstraints
dateRange.fromobjectyes
dateRange.toobjectyes
bodiesarray<enum(10)>no
zodiac"tropical" | "lahiri" | "fagan-bradley" | "krishnamurti" | "raman"no
sizePxintegernomin 240, max 1600, int
stepDaysnumbernomin 0.25, max 10
mode"light" | "dark"no
palette.backgroundstringno
palette.gridstringno
palette.textstringno

Example request

{
  "method": "circular",
  "dateRange": {
    "from": {
      "year": 2024,
      "month": 3,
      "day": 1
    },
    "to": {
      "year": 2024,
      "month": 3,
      "day": 31
    }
  }
}

Example response (captured; long values elided)

{
  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 760 760\" width=\"760\" height=\"760\"><rect width=\"760\" height=\"760\" fi… (219220 chars total)",
  "samples": 31,
  "bodies": [
    "Sun",
    "Moon",
    "Mercury",
    "Venus",
    "Mars",
    "Jupiter",
    "Saturn",
    "Uranus",
    "… 2 more items"
  ]
}

Rendered example

astro_render_ephemeris.circular example render (watchmaker style)

graphic

FieldTypeRequiredConstraints
dateRange.fromobjectyes
dateRange.toobjectyes
bodiesarray<enum(10)>no
modulusany | 30 | 45 | 60 | 90 | 360no
zodiac"tropical" | "lahiri" | "fagan-bradley" | "krishnamurti" | "raman"no
sizePxintegernomin 320, max 1600, int
stepDaysnumbernomin 0.25, max 10
overlay.labelstringnomaxLength 40
overlay.rowsarray<object>yes
mode"light" | "dark"no
palette.backgroundstringno
palette.gridstringno
palette.textstringno

Example request

{
  "method": "graphic",
  "dateRange": {
    "from": {
      "year": 2024,
      "month": 3,
      "day": 1
    },
    "to": {
      "year": 2024,
      "month": 5,
      "day": 31
    }
  }
}

Example response (captured; long values elided)

{
  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 760 456\" width=\"760\" height=\"456\"><defs>\n<path id=\"wm-admetos\" d=\"M… (120958 chars total)",
  "samples": 92,
  "overlayPointsUsed": 0,
  "bodies": [
    "Sun",
    "Moon",
    "Mercury",
    "Venus",
    "Mars",
    "Jupiter",
    "Saturn",
    "Uranus",
    "… 2 more items"
  ]
}

Rendered example

astro_render_ephemeris.graphic example render (watchmaker style)

graphic-declination

FieldTypeRequiredConstraints
dateRange.fromobjectyes
dateRange.toobjectyes
bodiesarray<enum(10)>no
sizePxintegernomin 320, max 1600, int
stepDaysnumbernomin 0.25, max 10
mode"light" | "dark"no
palette.backgroundstringno
palette.gridstringno
palette.textstringno

Example request

{
  "method": "graphic-declination",
  "dateRange": {
    "from": {
      "year": 2024,
      "month": 3,
      "day": 1
    },
    "to": {
      "year": 2024,
      "month": 5,
      "day": 31
    }
  }
}

Example response (captured; long values elided)

{
  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 760 490\" width=\"760\" height=\"490\"><defs>\n<path id=\"wm-admetos\" d=\"M… (117801 chars total)",
  "samples": 92,
  "oobBodies": [
    "Moon"
  ],
  "yAbs": 30
}

Rendered example

astro_render_ephemeris.graphic-declination example render (watchmaker style)