☿Mercurio Retrógrado en Piscis ♓ — activo ahora.Qué significa·Guía de supervivencia·Cómo te afecta
AprendeSolicitar acceso
API REST · Acceso anticipado

API de astrología
con precisión astronómica

API REST de astrología con sistema de casas Placidus, aspectos planetarios, retorno solar y renderizado SVG.
Bilingüe español e inglés. Lista para producción.

Solicitar acceso anticipadoVer endpoints
request.sh
curl -X POST https://api.mercurioretrogrado.com/v1/carta-natal \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "fecha": "1990-05-15",
    "hora": "14:30",
    "ciudad": "Buenos Aires, Argentina",
    "lang": "es"
  }'

Motor de cálculo astrológico real, no contenido genérico

Efemérides profesionales y posiciones planetarias geocéntricas. Construida para desarrolladores que necesitan precisión astronómica.

Cálculos astronómicos reales

Posiciones planetarias geocéntricas precisas con efemérides profesionales. No es contenido pre-escrito: es astronomía de verdad.

Sistema de casas Placidus

Cálculo iterativo de las 12 cúspides, ascendente y mediocielo. El sistema más usado en astrología occidental moderna.

Aspectos planetarios

Detección automática de conjunciones, trígonos, cuadraturas, oposiciones y sextiles con orbes configurables.

Renderizado SVG

Carta natal visual lista para embeber. SVG vectorial, responsive, con tema claro y oscuro. Sin dependencias del lado del cliente.

Bilingüe: español e inglés

Respuestas nativas en español e inglés con terminología astrológica correcta. No traducciones automáticas.

Velocidad y cero dependencias externas

Los cálculos se ejecutan localmente en milisegundos. Sin llamadas a APIs de terceros, sin latencia, sin límites de uso.

Endpoints de la API de astrología

Carta natal, retorno solar, tránsitos, compatibilidad e interpretación IA en una sola API.

POST/v1/carta-natal
Carta natal completa: planetas, casas, aspectos
POST/v1/retorno-solar
Carta del retorno solar para cualquier año
POST/v1/transitos
Posiciones planetarias en tiempo real
POST/v1/carta-natal/svg
Renderizado SVG de la carta natal
POST/v1/compatibilidad
Sinastría entre dos cartas natales
POST/v1/interpretacion
Interpretación en lenguaje natural con IA

Más endpoints en desarrollo. La API está en acceso anticipado.

Respuesta JSON estructurada

Posiciones planetarias, casas y aspectos en formato JSON listo para integrar.

response.json
{
  "planets": [
    { "name": "Sol", "symbol": "☉", "longitude": 54.23, "sign": "Tauro", "degree": "24° 14'" },
    { "name": "Luna", "symbol": "☽", "longitude": 287.91, "sign": "Capricornio", "degree": "17° 55'" },
    { "name": "Mercurio", "symbol": "☿", "longitude": 39.67, "sign": "Tauro", "degree": "9° 40'" }
  ],
  "houses": {
    "ascendant": 192.45,
    "midheaven": 102.18,
    "cusps": [192.45, 218.3, 248.7, 282.18, ...]
  },
  "aspects": [
    { "from": "Sol", "to": "Luna", "type": "trígono", "orb": 2.32 },
    { "from": "Venus", "to": "Marte", "type": "conjunción", "orb": 1.87 }
  ]
}

Casos de uso: quién necesita una API de astrología

Apps de astrología

Construye tu app de horóscopo o carta natal sin un motor de cálculo propio.

Plataformas de bienestar

Añade funcionalidades astrológicas a tu app de wellness, meditación o coaching.

Bots y asistentes

Integra astrología precisa en chatbots, asistentes de IA o plataformas de mensajería.

Contenido programático

Genera horóscopos, perfiles de famosos o reportes astrológicos a escala.

¿Por qué esta API?

Sin dependencias externas

Motor propio de cálculo. No dependemos de terceros. Los cálculos se ejecutan en milisegundos.

Español nativo

La única API con terminología astrológica correcta en español. No traducciones automáticas.

Probada en producción

El mismo motor que usamos en mercurioretrogrado.com con miles de cartas natales calculadas.

Preguntas frecuentes sobre la API

¿Qué tipo de cálculos realiza la API de astrología?
La API calcula posiciones planetarias geocéntricas reales usando efemérides astronómicas profesionales, sistema de casas Placidus con las 12 cúspides, ascendente y mediocielo, aspectos planetarios (conjunción, trígono, cuadratura, oposición, sextil) con orbes configurables, retorno solar y tránsitos en tiempo real.
¿La API funciona en español e inglés?
Sí. La API es bilingüe nativa: devuelve terminología astrológica correcta en español y en inglés, controlado por un parámetro lang. No son traducciones automáticas, sino nomenclatura astrológica revisada por profesionales.
¿Puedo obtener una carta natal como imagen SVG?
Sí. El endpoint /v1/carta-natal/svg genera una carta natal visual en formato SVG vectorial, responsive y lista para embeber en cualquier sitio web o app. Soporta tema claro y oscuro.
¿Qué sistema de casas utiliza?
Utilizamos el sistema de casas Placidus, el más usado en astrología occidental moderna. El cálculo es iterativo usando el método de semi-arcos diurnos y nocturnos para máxima precisión.
¿Necesito conocimientos de astrología para usar la API?
No necesariamente. La API devuelve datos estructurados en JSON con nombres legibles (signos, planetas, aspectos). También ofrece un endpoint de interpretación en lenguaje natural con IA para generar lecturas comprensibles para cualquier usuario.
¿Cuántas llamadas puedo hacer?
La API está en fase de acceso anticipado. Los cálculos se ejecutan localmente en milisegundos sin dependencia de servicios externos, por lo que la capacidad es alta. Contacta para discutir tus necesidades de volumen.
¿La API tiene dependencias externas o limita sus cálculos?
No. El motor de cálculo es propio y se ejecuta íntegramente en el servidor sin llamadas a APIs de terceros. Las posiciones planetarias se calculan con efemérides astronómicas, no se consultan servicios externos.
¿En qué se diferencia de otras APIs de astrología?
La mayoría de APIs de astrología devuelven contenido pre-escrito basado en el signo solar. Esta API calcula posiciones planetarias reales con coordenadas eclípticas, casas Placidus precisas, aspectos con orbes, y genera cartas natales en SVG. Es la única con soporte nativo en español.

Solicita acceso anticipado

Estamos en fase de acceso anticipado. Cuéntanos sobre tu proyecto y te contactamos con los detalles.