POST/api/astro/combination_yoga/1 crédito

Yogas de combinação

As janelas exatas, ao longo de um ano, em que vigora uma de vinte e três combinações de dia auspiciosas ou inauspiciosas. Esses yogas se formam por coincidência, e não pela posição dos planetas: um determinado dia da semana que cai junto com um determinado tithi e, em alguns casos, também com um determinado nakshatra. Tripushkara e Dwipushkara triplicam e duplicam o resultado de tudo o que for iniciado neles; Sarvartha Siddhi e Amrit Siddhi são auspiciosos de modo geral; Vish, Hutashan, Mrityu e Dagdha são o oposto. Oito deles — tripushkara, dwipushkara, sarvartha_siddhi, amrit_siddhi, siddha, naasha, sudha e halaahal — combinam tithi, dia da semana e o nakshatra da Lua. Os quinze restantes, cujos nomes começam com 'vt_' ou que levam o nome dos pares de dia da semana e tithi (kulika, samvarta, karkacha, dagdha, vish, hutashan, sheela e assim por diante), usam apenas dia da semana e tithi. Envie `year`, `yoga` e o local. A resposta é `{year, yoga, rows}`, em que rows é uma lista de `{start, end}` com timestamps ISO. As janelas são intervalos contínuos, cortados a cada virada de dia da semana, como aparecem impressas em um panchang, e não dias inteiros. Essa é a diferença entre este endpoint e a visão por dia de /api/astro/panchanga_yogas/, baseada só no nascer do sol, em que ocorrências curtas podem passar despercebidas.

https://api.occultapi.com/api/astro/combination_yoga/

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
latitude	number (double)	obrigatório	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)	obrigatório	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.
timezone_as_float	number (double)	obrigatório	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.
yoga	string	obrigatório	`tripushkaradwipushkarasarvartha_siddhiamrit_siddhisiddhanaashasudhahalaahalvt_siddharatnakurvt_amritvt_mrityu`
end_date	string (date)	opcional
start_date	string (date)	opcional
year	integer	opcional	Ano de nascimento como número, por exemplo 1990. Quatro dígitos. min 1800 · max 2400

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/combination_yoga/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"yoga":"tripushkara","year":2026}'

Resposta

{
  "data": {
    "year": 2026,
    "yoga": "tripushkara",
    "rows": [
      {
        "start": "2026-01-04T07:00:27+00:00",
        "end": "2026-01-04T09:41:29+00:00"
      },
      {
        "start": "2026-02-24T01:29:36+00:00",
        "end": "2026-02-24T01:32:39+00:00"
      },
      {
        "start": "2026-02-28T01:25:49+00:00",
        "end": "2026-02-28T04:05:11+00:00"
      },
      {
        "start": "2026-04-14T10:36:08+00:00",
        "end": "2026-04-14T18:42:51+00:00"
      },
      {
        "start": "2026-04-19T01:40:08+00:00",
        "end": "2026-04-19T05:19:46+00:00"
      },
      {
        "start": "2026-04-28T00:25:06+00:00",
        "end": "2026-04-28T13:22:23+00:00"
      },
      {
        "start": "2026-05-02T19:20:26+00:00",
        "end": "2026-05-03T00:21:07+00:00"
      },
      {
        "start": "2026-05-03T00:21:07+00:00",
        "end": "2026-05-03T01:40:06+00:00"
      },
      {
        "start": "2026-06-16T10:42:32+00:00",
        "end": "2026-06-16T19:22:54+00:00"
      },
      {
        "start": "2026-06-21T04:01:36+00:00",
        "end": "2026-06-21T09:51:10+00:00"
      },
      {
        "start": "2026-07-11T00:14:40+00:00",
        "end": "2026-07-11T05:33:48+00:00"
      },
      {
        "start": "2026-08-25T00:36:50+00:00",
        "end": "2026-08-25T00:51:22+00:00"
      },
      {
        "start": "2026-08-29T04:27:25+00:00",
        "end": "2026-08-29T22:12:28+00:00"
      },
      {
        "start": "2026-09-12T02:16:52+00:00",
        "end": "2026-09-12T07:25:29+00:00"
      },
      {
        "start": "2026-10-27T10:09:27+00:00",
        "end": "2026-10-27T22:37:23+00:00"
      },
      {
        "start": "2026-10-31T11:27:49+00:00",
        "end": "2026-11-01T00:09:53+00:00"
      },
      {
        "start": "2026-12-29T10:13:19+00:00",
        "end": "2026-12-30T01:49:19+00:00"
      }
    ]
  },
  "message": "successful",
  "is_error": false
}

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.