POST/api/astro/lunar/mansions/1 crédito

Mansões lunares

Em qual das vinte e oito manazil a Lua está. Vinte e oito divisões da eclíptica, de 12°51'26" cada, usadas em toda a astrologia eletiva e mágica do Ocidente medieval. NÃO são os nakshatras védicos, que são vinte e SETE e ficam em /api/astro/nakshatra/. As duas tradições dividem o mesmo círculo de formas diferentes, e uma mansão só se alinha com um nakshatra por coincidência; por isso, usar uma no lugar do outro é um erro de fato, e não questão de nomenclatura. As mansões são tropicais; os nakshatras são siderais. Retorna a mansão atual com o quanto a Lua já percorreu dela, o momento em que a Lua entra na próxima e a tabela completa das vinte e oito, para referência.

https://api.occultapi.com/api/astro/lunar/mansions/

Testar requisição

Autenticação

Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Campos da requisição

Campo	Tipo	Obrigatório	Observações
date_time	string (date-time)	obrigatório	O momento a calcular, em ISO 8601. SEMPRE inclua um deslocamento ou um Z no final - um valor sem fuso horário é lido como Asia/Kolkata (UTC+05:30), não como UTC, e pode retornar o resultado do dia anterior com um 200. '2026-09-01T06:00:00Z' e '2026-09-01 06:00:00' são instantes diferentes e dão respostas diferentes.
keys	array	opcional	Quais cálculos retornar, como uma lista de nomes. Veja a tabela de chaves deste endpoint; um nome não reconhecido rejeita a requisição inteira. Uma chamada custa um crédito, não importa quantas chaves você peça, então solicite tudo o que precisa de uma vez em vez de fazer várias chamadas.
latitude	number (double)	opcional	Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes.
longitude	number (double)	opcional	Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China.
orb_factor	number (double)	opcional	Multiplica todos os orbes de aspecto. 0.5 os reduz à metade; 2 os dobra. min 0.1 · max 2
timezone_as_float	number (double)	opcional	Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30), -5 para Nova York no inverno, 5.75 para o Nepal. Este valor NÃO é conferido com date_time: se os dois divergirem, você recebe uma resposta bem-sucedida para o momento errado. Por isso, tire os dois da mesma fonte. Use o deslocamento em vigor naquela data, não o de hoje: quem nasceu no verão, em um país com horário de verão, precisa do deslocamento de verão. min -12 · max 14

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/lunar/mansions/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Resposta

{
  "data": {
    "zodiac": "tropical",
    "as_of": "1990-08-15T05:00:00+00:00",
    "moon": {
      "longitude": 72.660043,
      "speed": 14.262958,
      "sign": "Gemini",
      "sign_index": 3,
      "degree_in_sign": 12.66,
      "formatted": "12°39' Gemini"
    },
    "mansion": {
      "number": 6,
      "name": "Al Hana",
      "from_degree": 64.285714,
      "to_degree": 77.142857,
      "degrees_into": 8.374328,
      "percent_through": 65.1337
    },
    "next_mansion": {
      "number": 7,
      "name": "Al Dhira",
      "enters_at": "1990-08-15T12:32:37+00:00"
    },
    "mansion_arc_degrees": 12.857143,
    "mansions": [
      {
        "number": 1,
        "name": "Al Sharatain",
        "from_degree": 0,
        "to_degree": 12.8571
      },
      {
        "number": 2,
        "name": "Al Butain",
        "from_degree": 12.8571,
        "to_degree": 25.7143
      },
      {
        "number": 3,
        "name": "Al Thurayya",
        "from_degree": 25.7143,
        "to_degree": 38.5714
      },
      {
        "number": 4,
        "name": "Al Dabaran",
        "from_degree": 38.5714,
        "to_degree": 51.4286
      },
      {
        "number": 5,
        "name": "Al Haqa",
        "from_degree": 51.4286,
        "to_degree": 64.2857
      },
      {
        "number": 6,
        "name": "Al Hana",
        "from_degree": 64.2857,
        "to_degree": 77.1429
      },
      {
        "number": 7,
        "name": "Al Dhira",
        "from_degree": 77.1429,
        "to_degree": 90
      },
      {
        "number": 8,
        "name": "Al Nathra",
        "from_degree": 90,
        "to_degree": 102.8571
      },
      {
        "number": 9,
        "name": "Al Tarf",
        "from_degree": 102.8571,
        "to_degree": 115.7143
      },
      {
        "number": 10,
        "name": "Al Jabhah",
        "from_degree": 115.7143,
        "to_degree": 128.5714
      },
      {
        "number": 11,
        "name": "Al Zubrah",
        "from_degree": 128.5714,
        "to_degree": 141.4286
      },
      {
        "number": 12,
        "name": "Al Sarfah",
        "from_degree": 141.4286,
        "to_degree": 154.2857
      },
      {
        "number": 13,
        "name": "Al Awwa",
        "from_degree": 154.2857,
        "to_degree": 167.1429
      },
      {
        "number": 14,
        "name": "Al Simak",
        "from_degree": 167.1429,
        "to_degree": 180
      },
      {
        "number": 15,
        "name": "Al Ghafr",
        "from_degree": 180,
        "to_degree": 192.8571
      },
      {
        "number": 16,
        "name": "Al Jubana",
        "from_degree": 192.8571,
        "to_degree": 205.7143
      },
      {
        "number": 17,
        "name": "Iklil al Jabhah",
        "from_degree": 205.7143,
        "to_degree": 218.5714
      },
      {
        "number": 18,
        "name": "Al Qalb",
        "from_degree": 218.5714,
        "to_degree": 231.4286
      },
      {
        "number": 19,
        "name": "Al Shaulah",
        "from_degree": 231.4286,
        "to_degree": 244.2857
      },
      {
        "number": 20,
        "name": "Al Naaim",
        "from_degree": 244.2857,
        "to_degree": 257.1429
      },
      {
        "number": 21,
        "name": "Al Baldah",
        "from_degree": 257.1429,
        "to_degree": 270
      },
      {
        "number": 22,
        "name": "Saad al Dhabih",
        "from_degree": 270,
        "to_degree": 282.8571
      },
      {
        "number": 23,
        "name": "Saad Bula",
        "from_degree": 282.8571,
        "to_degree": 295.7143
      },
      {
        "number": 24,
        "name": "Saad al Suud",
        "from_degree": 295.7143,
        "to_degree": 308.5714
      },
      {
        "number": 25,
        "name": "Saad al Akhbiyah",
        "from_degree": 308.5714,
        "to_degree": 321.4286
      },
      {
        "number": 26,
        "name": "Al Fargh al Mukdim",
        "from_degree": 321.4286,
        "to_degree": 334.2857
      },
      {
        "number": 27,
        "name": "Al Fargh al Thani",
        "from_degree": 334.2857,
        "to_degree": 347.1429
      },
      {
        "number": 28,
        "name": "Batn al Hut",
        "from_degree": 347.1429,
        "to_degree": 360
      }
    ],
    "note": "Twenty-eight Arabic manazil, not the twenty-seven Vedic nakshatras — see /api/astro/nakshatra/ for those. These are tropical; the nakshatras are sidereal."
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.

Erros

Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.