POST
/chartCalcula um mapa completo
O endpoint principal. Recebe um instante e um lugar; devolve o mapa inteiro — posições, casas, aspectos, dignidades, estrelas fixas, partes árabes, temperamento, mentalidade e motivação primária. Nada é gravado. A profecção NÃO sai daqui: ela precisa de um quarto dado que não é do mapa (o instante a situar), e por isso tem endpoint próprio.
Corpo
| Campo | Tipo | Descrição |
|---|---|---|
| datetime_local* | string | Data e hora LOCAIS do lugar, ISO 8601: '1990-03-15T14:32:00'. Não converta para UTC — o Placidus faz isso com a regra de fuso da data. Alternativa: `jd_ut`. |
| timezone | string | Fuso IANA ('America/Sao_Paulo'). Opcional: sem ele, é resolvido pela cidade (`place`) ou pela coordenada. |
| jd_ut | number | Julian Day UT — o instante já resolvido, sem ambiguidade de fuso. Use quando estiver encadeando chamadas: ele vem em `meta.jd_ut` de toda resposta. |
| lat | number | Latitude decimal, −90 a 90. Obrigatória junto com `lon`, salvo se mandar `place`. |
| lon | number | Longitude decimal, −180 a 180. Negativa a oeste de Greenwich. |
| place | string | Cidade por extenso: 'Goiânia, GO', 'Kesswil, CH'. Resolve lat, lon e fuso de uma vez. Havendo homônimos, vence a de maior população — a cidade escolhida volta em `meta.place`, então dá para conferir. Para escolher você mesmo, use `GET /places`. |
| technique | string | Configuração de partida: 'natal' (padrão), 'horaria' (Regiomontanus, orbe apertado, Parte da Demissão) ou 'eleicao'. Acentos e apelidos em inglês são aceitos. Consulte `GET /techniques`. Técnica é rótulo: isto muda defaults, não comportamento. |
| config | object | Configuração explícita do cálculo — sistema de casas, orbes, tabelas de dignidade, o que ligar e desligar. Vence a `technique`. Ver a seção Configuração. |
| sections | string[] | Só estas seções voltam. Omitido, vem tudo. `meta` volta sempre. Recorta a RESPOSTA, não o cálculo. |
| exclude | string[] | Seções a remover da resposta. Útil para cortar as pesadas (`fixed_stars`). |
Requisição
curl -X POST https://placidus.app/api/public/v1/chart \
-H "X-API-Key: $PLACIDUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"datetime_local": "1875-07-26T19:32:00",
"place": "Kesswil, CH"
}'Resposta
{
"meta": {
"jd_ut": 2406096.2932175924,
"datetime_utc": "1875-07-26T19:02:14Z",
"timezone": "Europe/Zurich",
"tz_offset_hours": 0.4961111111111111,
"location": { "lat": 47.5983, "lon": 9.3216 },
"house_system": "placidus",
"sect": "nocturnal",
"engine_version": "0.2.0"
},
"bodies": [
{
"id": "sun",
"name": "Sol",
"longitude": 123.31565476363885,
"sign": "Leão",
"sign_index": 4,
"deg": 3, "min": 18, "sec": 56,
"latitude": 0.00006471318014565755,
"speed": 0.9558238152095152,
"speed_lat": 0.00001954998409620958,
"retrograde": false,
"motion": {
"direction": "direct", "direction_pt": "direto",
"pace": "slow", "pace_pt": "lento",
"reading_pt": "direto e lento",
"speed": 0.9564, "mean_speed": 0.9856
},
"house": 7,
"solar_orientation": "occidental",
"dignities": {
"traditional": true,
"domicile": true, "exaltation": false, "triplicity": false,
"term": false, "face": false, "detriment": false, "fall": false,
"peregrine": false,
"triplicity_ruler": "jupiter", "term_ruler": "saturn", "face_ruler": "saturn",
"sign_ruler": "saturn", "exaltation_ruler": null,
"detriment_of": "sun", "fall_of": null,
"score": 5
},
"accidental": {
"score": 7,
"factors": [
{ "name": "casa 7", "points": 4 },
{ "name": "lento", "points": -2 },
{ "name": "latitude norte aumentando", "points": 2 },
{ "name": "hayz", "points": 3 }
],
"combust": false
}
}
// … os outros 9 corpos
],
"moon_phase": { "quadrant": 3, "humor": "phlegmatic", "humor_pt": "Fleumático" },
"angles": [
{ "id": "asc", "name": "Ascendente", "longitude": 304.14859735082854,
"sign": "Aquário", "sign_index": 10, "deg": 4, "min": 8, "sec": 55 }
// … mc, ic, dsc
],
"points": [
{ "id": "north_node", "name": "Nodo Norte", "longitude": 10.925703810632907,
"sign": "Áries", "sign_index": 0, "deg": 10, "min": 55, "sec": 33, "house": 2 }
// … south_node
],
"houses": {
"system": "placidus",
"cusps": [304.14859735082854, 358.3127605423338 /* … 12 cúspides, em graus */]
},
"aspects": [
{ "from": "sun", "to": "neptune", "type": "square",
"orb": 0.27333089374567976, "orb_deg": 0, "orb_min": 16,
"applying": false, "sign_gated": true },
{ "from": "saturn", "to": "ic", "type": "conjunction",
"orb": 4.73, "orb_deg": 4, "orb_min": 44,
"applying": true, "sign_gated": true }
],
"fixed_stars": {
"mode": "closest",
"magnitude_floor": { "value": 3, "inclusive": true, "chart_kind": "natal" },
"magnitude_source": "swiss",
"include_nebulae": false,
"bypassed_floor_count": 0,
"fundamental_list": ["ALDEBARAN", "ALGOL", "ANTARES", "ARCTURUS", "/* … 12 */"],
"revolution_wide_orb_list": [],
"orb_table": { "kind": "natal_by_magnitude", "nebula_deg": 1 },
"conjunctions_found": 14,
"discarded_by_magnitude": 9,
"discarded_by_sign": 1,
"mythological_list": ["ALDEBARAN", "ALFARD", "ALGOL", "/* … 13 */"],
"pending": [],
"formula_version": "estrelas-yuri-6",
"active": [
{ "name_swiss": "Regulus", "name": "Regulus", "longitude": 149.08,
"sign": "Leão", "deg": 29, "min": 5, "sec": 12,
"magnitude": 1.35, "magnitude_source": "swiss",
"object_type": "star", "fundamental": true, "mythological": true,
"elected_by": "fundamental", "bypassed_floor": false,
"planetary_nature": "Mars-Jupiter", "constellation": "Alpha Leonis",
"conjunct_to": "asc", "conjunct_to_name": "Ascendente",
"orb_deg": 0, "orb_min": 53, "orb_limit_deg": 2.0,
"reading_source": "verbete_pt",
"interpretation": {
"key": "REGULUS", "verbete": "Regulus é a estrela do coração do Leão…",
"significado": "…", "mitologia": "…", "encaixe_interpretativo": "…",
"catalog_sign": "Virgem"
},
"won_over": [
{ "name_swiss": "Phecda", "magnitude": 2.5,
"orb_deg": 0, "orb_min": 15, "reason": "a outra é fundamental" }
] }
],
"searched": [ /* … */ ]
},
"arabic_parts": [
{ "id": "fortuna", "name": "Parte da Fortuna",
"longitude": 21.877916825632383, "sign": "Áries",
"deg": 21, "min": 52, "sec": 41, "house": 2,
"formula": "asc + sol - lua", "sect": "nocturnal",
"conjunctions": [], "description": "Indica onde se manifestam a sorte material…" }
// … as outras 7
],
"strength_ranking": [
{ "body": "moon", "name": "Lua", "score": 8, "accidental_score": 10,
"combust": false, "house_strength": 2, "rank": 1, "lord_of_nativity": true }
// … os demais, em ordem
],
"antiscia": [
{ "body": "sun", "kind": "body", "name": "Sol",
"antiscion": { "longitude": 56.68434523636115, "sign": "Touro", "deg": 26, "min": 41 },
"contra_antiscion": { "longitude": 236.68434523636114, "sign": "Escorpião", "deg": 26, "min": 41 },
"antiscion_hits": [
{ "point": "cusp_6", "point_name": "Cúspide 6",
"orb_deg": 1, "orb_min": 12, "orb_limit_deg": 3 }
],
"contra_antiscion_hits": [] }
],
"temperament": {
"result": "Fleumático",
"humor": "phlegmatic",
"signature_pt": "umidade forte, frio forte",
"points": [
{ "point": "ascendant", "detail": "Aquário (Ar)", "humor": "sanguine", "active": "hot", "passive": "wet" },
{ "point": "asc_ruler", "detail": "Saturno", "humor": "melancholic", "active": "cold", "passive": "dry" },
{ "point": "moon_phase", "detail": "Minguante (Água)", "humor": "phlegmatic", "active": "cold", "passive": "wet" },
{ "point": "sun_season", "detail": "Leão — verão", "humor": "choleric", "active": "hot", "passive": "dry" }
],
"tally": { "active": { "hot": 2, "cold": 2 }, "passive": { "dry": 2, "wet": 2 } },
"modulation": [
{ "source": "lord", "detail": "Lua", "active": "cold", "passive": "wet" },
{ "source": "lord_sign", "detail": "Touro (Terra)", "active": "cold", "passive": "dry" },
{ "source": "asc_ruler_sign", "detail": "Aquário (Ar)", "active": "hot", "passive": "wet" },
{ "source": "sun_sign", "detail": "Leão (Fogo)", "active": "hot", "passive": "dry" },
{ "source": "aspect", "detail": "Mercúrio à Lua, 1°49'", "active": "cold", "passive": "wet" },
{ "source": "aspect", "detail": "Vênus à Lua, 1°55'", "active": "cold", "passive": "wet" },
{ "source": "aspect", "detail": "Sol ao Ascendente, 0°50'", "active": "hot", "passive": "dry" }
],
"modulation_tally": { "active": { "hot": 3, "cold": 4 }, "passive": { "dry": 3, "wet": 4 } },
"reinforcement": {
"active": { "quality": "cold", "for": 4, "against": 3, "reinforced": true, "reading_pt": "frio forte" },
"passive": { "quality": "wet", "for": 4, "against": 3, "reinforced": true, "reading_pt": "umidade forte" }
},
"imbalance": { "quality": null, "tied": ["cold", "wet"], "testimonies": 4, "of": 7,
"reading_pt": "sem excesso definido — frio e umidade empatam" },
"resolution": { "active": { "quality": "cold", "via": "modulation", "weak": true },
"passive": { "quality": "wet", "via": "modulation", "weak": true } },
"notes": [],
"formula_version": "temperamento-yuri-4"
},
"mentality": {
"result": "Júpiter associado a Vênus",
"combination": { "kind": "pair", "planets": ["jupiter", "venus"] },
"moon_almuten": { "planet": "venus", "name": "Vênus", "score": 5 },
"mercury_almuten": { "planet": "jupiter", "name": "Júpiter", "score": 4 },
"pole": {
"side": "light", "side_pt": "Luz",
"decided_by": "essential_testimonies",
"essential_counts": { "dignified": 2, "debilitated": 0, "mixed": 0, "peregrine": 2 },
"counterweight": {
"favorable": ["Mercúrio em lugar próprio", "Sol bem recebido (3 a favor, 1 contra)"],
"unfavorable": ["Saturno retrógrado"],
"neutral": ["modalidade cardinal", "significadores orientais"],
"balance": "attenuated",
"reading_pt": "luz confirmada — os definidores caem para o melhor, e o conjunto do mapa sustenta"
}
},
"modality": { "mode": "cardinal", "text_pt": "Mente extrovertida, polêmica, engenhosa…" },
"orientality": { "state": "oriental", "decided_by": "maioria na orientalidade", "text_pt": "Tornam a mente constante…" },
"modifiers": [
{ "factor": "lua_nodos", "aspect": "square", "orb_deg": 2, "orb_min": 14,
"text_pt": "Mentalidade mais sensível, artística e volúvel." }
],
"formula_version": "mentalidade-yuri-7"
},
"primary_motivation": {
"result": "Libra, por Vênus em Touro (domiciliado)",
"question_pt": "Que tipo de bem eu sou capaz de realizar e desfrutar?",
"inspiration": { "point": "ascendant", "ruled_by": "sign", "sign": "Libra",
"text_pt": "Diferenciar os lados da situação; estabelecer alianças; equilibrar; compensar." },
"best_action": { "point": "asc_ruler", "ruled_by": "planet", "planet": "venus", "name": "Vênus",
"verbs": ["fruir", "adornar", "embelezar", "enriquecer"],
"sign": "Touro", "mode_pt": "Enriquecer; aumentar o valor das coisas; embelezar." },
"result_to_obtain": { "point": "dispositor", "planet": "venus", "chain_stopped": true,
"reason": "ruler_in_domicile", "text_pt": "A dificuldade é descrita pela mesma função…" },
"special_cases": [ { "kind": "ruler_in_domicile", "text_pt": "…" } ],
"profession_examples": [ { "name": "designer de produto", "source_planet": "venus",
"mode_sign": "Touro", "verb": "embelezar/adornar", "why": "…" } ],
"hobby_criteria": { "automatic_examples_allowed": false,
"examples_status": "action_candidates", "composition_rule_pt": "…" },
"hobby_examples": [{ "name": "…", "source_planet": "venus", "verb": "…" }], "catalog_version": "2026-09-14",
"formula_version": "motivacao-yuri-4"
}
}