¿Qué es la astrología electiva y cómo la automatiza esta API?

La astrología electiva consiste en elegir el mejor momento astrológico para empezar algo importante. Tradicionalmente, los astrólogos dedican de 1 a 4 horas a revisar cientos de momentos candidatos frente a criterios ponderados. Nuestra API automatiza todo el proceso: envías una actividad y un rango de fechas, y recibes ventanas puntuadas de 0-100 con desgloses de factores y razonamiento en lenguaje natural en menos de 2 segundos. Tres endpoints: /search para rangos de fechas, /evaluate para momentos individuales, /glossary para la taxonomía de actividades.

¿Qué la diferencia de las API védicas de muhurta como Prokerala o KundliAPI?

Dos diferencias fundamentales. Primero, nosotros hacemos astrología electiva occidental (zodíaco tropical, casas Placidus, dignidades planetarias tradicionales), mientras que Prokerala/KundliAPI hacen muhurta védico (sideral, Choghadiya, Tithi). Segundo, ellos devuelven binarios propicio/no propicio o listas planas de fechas. Nosotros devolvemos puntuaciones numéricas 0-100 con desgloses de 31 factores, mapas de calor por calendario y texto de razonamiento en lenguaje natural. Nadie más ofrece justificantes de factores.

¿Cuánto cuesta la API de Astrología Electiva?

Plan gratuito: 50 solicitudes/mes. Starter: $11/mes por 1.000 solicitudes. Professional: $37/mes por 55.000 solicitudes. Business: $99/mes por 220.000 solicitudes. Enterprise: $399+/mes por uso ilimitado. Compáralo con el software electivo de escritorio a $300-700 de pago único, o con las consultas electivas profesionales a $300-800 cada una.

¿Qué tan rápida es la búsqueda electiva para rangos de fechas grandes?

Una búsqueda de 90 días se completa en menos de 2 segundos en el p95. Una búsqueda de 367 días (máximo) tarda unos 4-5 segundos. La evaluación de un solo momento con /evaluate responde en menos de 300ms. El rendimiento viene de la arquitectura en dos pasadas: primero un mapa de calor rápido a nivel de día, luego la profundización de precisión solo en los mejores días. La caché Redis aporta una aceleración de 430x en solicitudes repetidas.

¿Cómo funciona la regla de seguridad por zona del cuerpo para cirugía y odontología?

Cuando la actividad es 'surgery', debes proporcionar extra_params.body_area (una de 15 zonas: cabeza, cara, cuello, garganta, brazos, pecho, corazón, estómago, espalda, riñones, zona reproductiva, muslos, rodillas, pantorrillas, pies). La API impone la regla tradicional: la Luna no debe estar en el signo del zodíaco que rige esa zona del cuerpo. La actividad 'dental' (dientes y mandíbula) comparte la misma lógica de seguridad de Luna en signo por zona del cuerpo. Para emergencias, configura emergency_mode: true para anular los bloqueos absolutos con texto de aviso obligatorio.

¿Qué es el mapa de calor por calendario y cómo lo uso?

El mapa de calor es un resumen de puntuación día a día de todo el rango de búsqueda. Cada día recibe una puntuación compuesta (calculada al mediodía) y un grupo de calificación (excelente/bueno/aceptable/malo/bloqueado). Renderízalo como un calendario codificado por color en tu interfaz. Los usuarios ven de un vistazo qué semanas son favorables y luego profundizan en días concretos para obtener recomendaciones detalladas de ventanas.

¿Qué son los justificantes de factores y por qué importan?

Cada ventana puntuada incluye un desglose completo factor por factor: 31 evaluaciones individuales de factores que muestran el nombre del factor, el nivel de cumplimiento (0.0-1.0), el texto de observación, la contribución del peso y el estado. Es como un justificante de la puntuación. Los astrólogos profesionales pueden verificar y defender cada recomendación ante sus clientes. Ningún competidor ofrece este nivel de transparencia.

¿Cómo integro la API electiva en mi aplicación?

API REST estándar. POST a /api/v3/electional/search con activity, date_range y location. La respuesta es JSON con heatmap, top_windows y excluded_ranges. Para un solo momento: POST a /evaluate. Para menús desplegables de la interfaz: GET /glossary/activities. SDK para JavaScript, Python, PHP y Ruby. La mayoría de los desarrolladores integran el flujo básico en menos de 1 hora.

¿Puedo usarla con agentes de IA y LLM?

Sí, está diseñada para ello. La herramienta MCP find_best_time ya está registrada para la integración con agentes de IA con Claude, ChatGPT y agentes personalizados. Configura summary_mode: true para una salida compacta que quepa en las ventanas de contexto del chat (3 mejores ventanas + razonamiento de 1 línea). El endpoint /glossary/activities proporciona sinónimos de actividades para la clasificación de intención por LLM.

¿Qué bloqueos absolutos comprueba el motor electivo?

23 verificadores de bloqueo absoluto dedicados evalúan: eclipses solares y lunares (ventanas asimétricas), periodos retrógrados de Mercurio/Venus/Marte, Luna vacía de curso, planetas combustos, conflictos de Luna en signo por zona del cuerpo (cirugía) y condiciones específicas de la actividad. Los momentos bloqueados se excluyen por completo de los resultados con explicaciones en el array excluded_ranges.

¿Qué tan precisos son los cálculos astronómicos?

Datos de Swiss Ephemeris JPL DE431 con una precisión de 0,001 segundos de arco. La misma fuente de datos que usa la NASA. Las posiciones planetarias, aspectos, fases lunares, eclipses, retrogradaciones e ingresos se calculan todos a partir de estas efemérides de referencia. Tres rondas de validación por parte de astrólogos en activo confirmaron que todos los factores devuelven resultados correctos.

¿Puedo filtrar los resultados de búsqueda por hora del día o día de la semana?

Sí. El parámetro filters acepta hours_from y hours_to (p. ej., 9-21 para solo horas diurnas), days_of_week (p. ej., ['fri', 'sat', 'sun'] para bodas de fin de semana) y exclude_dates para omitir fechas concretas. Esto reduce drásticamente el espacio de búsqueda y mejora la relevancia.

¿Qué lenguajes de programación funcionan con la API electiva?

Cualquier lenguaje con soporte HTTP. SDK oficiales para JavaScript/Node.js, Python, PHP y Ruby. La API devuelve JSON estándar. La mayoría de los desarrolladores integran con fetch/axios en apps de frontend o requests/httpx en servicios de backend. Especificación OpenAPI completa disponible para autogenerar clientes en cualquier lenguaje.

¿Hay un plan gratuito para la API electiva?

Sí, 50 solicitudes gratuitas cada mes. Es suficiente para probar el flujo completo de búsqueda y evaluación, explorar las 34 actividades predefinidas y crear un prototipo de tu integración antes de comprometerte con un plan de pago. El plan gratuito incluye todas las funciones, sin restricciones de características.

¿Cómo gestiona la actividad de boda a Venus retrógrado?

La actividad de boda incluye Venus retrógrado como bloqueo absoluto: cualquier momento durante Venus Rx queda excluido de los resultados con una explicación. También aplica un aviso de retorno de Saturno si la carta natal muestra un retorno de Saturno dentro del rango de búsqueda, y la exclusión de Luna vacía de curso para los momentos de la ceremonia. La dignidad de Venus y la fase lunar están entre los factores con mayor peso.

¿Puedo usar la API para los momentos de lanzamiento de un negocio?

Sí, la actividad de negocio es una de las 34 admitidas. Prioriza las condiciones de Mercurio (evitando retrógrado y combusto), los aspectos de Júpiter para el crecimiento, la fase de la Luna (preferiblemente creciente) y la fuerza de la casa 10. Los bloqueos absolutos incluyen Mercurio Rx, eclipses y Luna vacía de curso. Hay actividades separadas para firma/contrato, lanzamiento de producto, compra, venta y préstamo, de modo que puedes elegir la que coincida con el evento de negocio exacto.

¿Cómo puntúan los momentos de matrimonio, cortejo y divorcio?

Cada uno es su propia actividad. Matrimonio y cortejo ponderan mucho las condiciones de Venus (dignidad, aspectos, libertad de retrogradación y combustión), favorecen una Luna creciente y excluyen la Luna vacía de curso y los eclipses. El divorcio usa factores de área de vida distintos: no persigue tanto un momento 'afortunado' como evitar las peores condiciones de la Luna y de maléfico en ángulo para una ruptura limpia. Los tres devuelven puntuaciones 0-100 con calificaciones y razonamiento por ventana, de modo que los usuarios ven por qué una fecha supera a otra.

¿Puedo encontrar el mejor momento para un corte de pelo o un procedimiento estético?

Sí. Las actividades de corte de pelo y procedimiento estético usan los momentos lunares tradicionales: una Luna creciente para el crecimiento (buena para cortes de pelo en los que se busca un recrecimiento más abundante) y factores de Luna en signo por zona del cuerpo. Son funciones cotidianas de autocuidado para apps de bienestar. Envía la actividad 'haircut' o 'cosmetic procedure' con un rango de fechas y una ubicación, y recibe ventanas puntuadas con calificaciones de excelente a malo.

¿La API admite los momentos de siembra y cosecha para la agricultura?

Sí. Las actividades de siembra y cosecha usan preferencias de Luna creciente/menguante y mansiones lunares, la base tradicional de los momentos electivos agrícolas. La siembra suele favorecer una Luna creciente para los cultivos de superficie; la cosecha favorece una Luna menguante para el almacenamiento. Ambas devuelven puntuaciones 0-100, un mapa de calor por calendario para toda la temporada y un razonamiento que explica la fase lunar y la lógica de la Luna en signo para cada ventana.

¿Qué calificaciones devuelve la API junto con la puntuación?

Cada puntuación 0-100 se asigna a una calificación: excelente (90-100), bueno (75-89), aceptable (60-74), precaución (40-59), malo (0-39). La calificación da a tu interfaz una etiqueta y un grupo de color instantáneos sin que definas umbrales. El mapa de calor por calendario usa la misma graduación, de modo que los usuarios escanean un mes entero y detectan de un vistazo los días excelentes, y luego profundizan en ventanas concretas.

¿Qué idiomas admite el texto de razonamiento?

9 idiomas: inglés, ruso, alemán, español, francés, italiano, portugués, chino e hindi. Configura el parámetro language y el razonamiento en lenguaje natural, las observaciones de factores y las explicaciones de rangos excluidos vuelven localizados. Esto significa que puedes ofrecer funciones de momentos astrológicos a una audiencia global sin escribir tus propias traducciones del texto de razonamiento.

¿Puedo controlar la precisión de las ventanas candidatas?

Sí, con el parámetro granularity: 1m, 5m, 15m, 1h, 4h o 1d. Usa 1d o 4h para un escaneo rápido de toda una temporada, y luego 1m o 5m para fijar la hora exacta de inicio de una ceremonia o cirugía dentro de los mejores días. La búsqueda en dos pasadas lo mantiene rápido: primero se ejecuta el mapa de calor a nivel de día y luego la pasada de precisión profundiza solo en los mejores días con la granularidad que elijas.

¿Las 34 actividades predefinidas están revisadas por astrólogos reales?

Sí. El catálogo creció desde el conjunto original hasta 34 actividades predefinidas a lo largo de tres oleadas de lanzamiento (Oleadas 1-3), cada una revisada por astrólogos. Los revisores comprobaron los pesos de los factores, las reglas de bloqueo absoluto y la lógica específica de cada actividad: Luna en signo por zona del cuerpo para cirugía y odontología, énfasis en Venus para matrimonio y cortejo, Luna creciente/menguante para siembra y cosecha. Las reglas siguen la práctica electiva tradicional, no una puntuación arbitraria.

¿Puedo imponer mis propias reglas estrictas, como "la Luna debe estar creciente"?

Sí. Además del motor de puntuación 0-100, puedes pasar filtros de criterios estrictos personalizados que toda ventana devuelta DEBE satisfacer. Los filtros admitidos incluyen moon_waxing (la Luna debe estar creciente), planet_dignified (un planeta elegido debe estar en su dignidad) y planet_angular (un planeta elegido debe estar en un ángulo). Funcionan como filtros de aprobado/rechazado, no como ajustes suaves de la puntuación: cualquier momento que no pase un filtro queda excluido de los resultados, de modo que puedes imponer reglas electivas innegociables que exija tu tradición sin tocar los pesos de las actividades predefinidas.

¿Marcáis los planetas combustos en la ventana elegida?

Sí. /search y /evaluate devuelven combust_flags por significador, que muestran qué planetas están combustos (demasiado cerca del Sol) en cada ventana puntuada. Puedes leer los flags para ver y evitar un significador combusto antes de recomendar una fecha. La combustión ya se tiene en cuenta en la puntuación y en los bloqueos absolutos, pero combust_flags la expone de forma explícita por cada significador para que tu interfaz pueda avisar a los usuarios o permitirles filtrar las ventanas combustas.

¿Puedo renderizar la carta de un momento recomendado sin una segunda llamada?

Sí. Cada ventana puntuada en /search y /evaluate ahora devuelve body_positions: las posiciones planetarias completas (signo, grado y casa) en ese momento exacto. Las lees directamente de la respuesta y dibujas la carta de cualquier momento recomendado en tu interfaz, sin necesidad de una solicitud de seguimiento. Esto ahorra un viaje de ida y vuelta: elige una ventana destacada, renderiza su rueda desde el mismo payload y muéstrale a los usuarios el cielo real que hay detrás de la puntuación.

Astrología Electiva

Encuentra el Mejor Momento para Cualquier Cosa. Puntuado 0-100.

Primera API REST de astrología electiva occidental con puntuación numérica.

Mapa de calor por calendario, 34 actividades predefinidas (cirugía, matrimonio, negocios, siembra, corte de pelo y más), desglose de factores con justificantes y razonamiento en lenguaje natural en 9 idiomas. Ningún competidor lo ofrece. Mercado vacío confirmado.

Ver Documentación

0-100

Puntuación Numérica

Actividades Predefinidas

Evaluadores de Factores

<2s

Búsqueda de 90 Días

Primera API REST electiva occidental

Precisión Swiss Ephemeris

Lista para MCP y agentes de IA

Herramientas solo de escritorio (Solar Fire, Janus): sin API, sin puntuación, interfaz de los años 90
Herramientas web (Astro-Seek): puntuación opaca, máximo 90 días, sin exportación
API védicas (Prokerala, KundliAPI): solo binario propicio/no propicio, sin enfoque occidental
KundliAPI devuelve listas planas de fechas sin puntuaciones, sin mapas de calor, sin justificaciones
Ninguna API existente devuelve desgloses de factores, razonamiento en lenguaje natural ni mapas de calor por calendario

Transforma con

Puntuación numérica 0-100 con justificantes transparentes factor por factor
Mapa de calor por calendario para escanear rangos de fechas de un vistazo
34 actividades predefinidas: cirugía, matrimonio, negocios, contratos, siembra, corte de pelo, divorcio y más
Razonamiento en lenguaje natural por ventana en 9 idiomas: "por qué este momento es bueno"
Herramienta find_best_time invocable por MCP para agentes de IA e integración con LLM

Rendimiento de la API Electiva

Diseñada para producción, validada por astrólogos

0-100

Rango de Puntuación

Actividades Predefinidas

31 + 23

Factores + Bloqueos Absolutos

<2 segundos

Búsqueda de 90 Días

<300ms

Evaluación Individual

293 pruebas

Cobertura de Pruebas

Funciones Completas de Astrología Electiva

31 factores, 23 bloqueos absolutos, 34 actividades predefinidas, 9 idiomas, 3 endpoints

Búsqueda por Rango de Fechas

Evaluación de un Solo Momento

34 Actividades Predefinidas

Motor de Puntuación

Integración con IA y LLM

Calificaciones y Localización

Ventanas Listas para Carta

Puntuación Explicable

¿Qué Es la API de Astrología Electiva? Guía Completa para Desarrolladores

La primera API REST para encontrar momentos astrológicamente óptimos, con puntuaciones reales

¿Qué es la astrología electiva? Es la práctica milenaria de elegir el mejor momento para iniciar algo importante: una cirugía, un matrimonio, el lanzamiento de un negocio, la firma de un contrato, incluso plantar un jardín o cortarse el pelo. La API cubre ahora 34 actividades predefinidas, todas revisadas por astrólogos a lo largo de tres oleadas de lanzamiento. Los astrólogos profesionales cobran entre $300 y $800 por consulta electiva y dedican de 1 a 4 horas a revisar manualmente cientos de momentos candidatos. Nuestra API de Astrología Electiva es el primer endpoint REST que automatiza todo este proceso con salida JSON estructurada. Envías una actividad y un rango de fechas, y recibes una puntuación de 0-100 para cada momento candidato, un mapa de calor por calendario que muestra de un vistazo los días buenos frente a los malos, un desglose factor por factor que explica exactamente por qué cada puntuación es la que es, y texto de razonamiento en lenguaje natural en 9 idiomas (en, ru, de, es, fr, it, pt, zh, hi). Ningún otro proveedor de API ofrece puntuación electiva occidental: lo comprobamos con Solar Fire, Janus, AstroApp, Prokerala, AstrologyAPI.com, KundliAPI y VedicRishi. Todos confirman el vacío. La oferta védica devuelve clasificaciones binarias de muhurta, no puntuaciones numéricas. Este es un mercado genuinamente vacío.

¿Cómo funciona la API de Astrología Electiva?

Tres endpoints impulsan todo el sistema.

POST /search acepta una actividad (como 'surgery' o 'marriage'), un rango de fechas (hasta 367 días) y una ubicación.

Ejecuta una búsqueda en dos pasadas: primero una pasada rápida de mapa de calor a nivel de día que puntúa cada día al mediodía, y luego una pasada de precisión que profundiza en los mejores días con la granularidad que configures (ventanas de 1m, 5m, 15m, 1h, 4h o 1d).

El resultado es un mapa de calor por calendario con días graduados por color, las mejores ventanas ordenadas con puntuaciones individuales, rangos de fechas excluidos (eclipses, retrogradaciones, etc.) con explicaciones, y razonamiento en lenguaje natural por ventana.

POST /evaluate puntúa un momento concreto específico, ideal para comprobaciones del tipo '¿es buena esta fecha?'.

GET /glossary/activities devuelve las 34 actividades admitidas con sinónimos para la detección de intención por LLM y los menús desplegables de la interfaz.

Búsqueda en dos pasadas: primero el mapa de calor, luego la profundización de precisión en los mejores días

1 min read

¿Qué hace única a esta API electiva?

Cinco cosas que ningún competidor ofrece: (1) Puntuación numérica 0-100 con curvas de saturación, no un sí/no binario ni un vago 'bueno/malo'.

(2) Mapa de calor por calendario: graduación visual día a día de todo un rango de fechas.

(3) Desglose factor por factor ('justificantes'): cada puntuación viene con 31 evaluaciones individuales de factores que muestran el nivel de cumplimiento, la observación y la contribución a la puntuación final.

Los astrólogos profesionales pueden defender cada recomendación.

(4) Razonamiento en lenguaje natural en 9 idiomas: explicaciones generadas automáticamente por ventana, listas para mostrarse a los usuarios o alimentar a los LLM.

(5) 34 actividades predefinidas con pesos ajustados: una elección de matrimonio prioriza las condiciones de Venus de forma distinta a una elección de cirugía, y la siembra pondera de otra manera la fase lunar y la fertilidad de la Luna en signo.

Cada actividad predefinida tiene pesos calibrados profesionalmente que suman 100 y revisados por astrólogos a lo largo de tres oleadas de lanzamiento.

La única API con puntuación numérica + mapa de calor + justificantes de factores + razonamiento en lenguaje natural

1 min read

¿Qué actividades admite la API electiva?

34 actividades predefinidas, todas revisadas por astrólogos a lo largo de tres oleadas de lanzamiento.

Salud y cuerpo: cirugía, odontología (dientes y mandíbula), medicación, concepción, parto, procedimiento estético, corte de pelo, destete.

Relaciones y eventos vitales: matrimonio, cortejo, divorcio, imposición de nombre.

Negocios y dinero: negocio, firma/contrato, lanzamiento de producto, compra, venta, préstamo, inversión, contratación, despido.

Propiedad y desplazamientos: mudanza, reubicación, alquiler, asentamiento, viaje.

Trabajo y aprendizaje: examen, entrevista, estudio.

Tierra y crecimiento: siembra, cosecha.

Más las originales como boda y lanzamiento.

Cada actividad predefinida define sus propios pesos de factores y reglas de bloqueo absoluto.

Cirugía y odontología imponen la seguridad de la Luna en signo según la zona del cuerpo: la cirugía requiere un parámetro body_area (15 zonas: cabeza, cara, cuello, garganta, brazos, pecho, corazón, estómago, espalda, riñones, zona reproductiva, muslos, rodillas, pantorrillas, pies) y la regla tradicional de que la Luna no debe estar en el signo que rige la parte del cuerpo que se va a operar.

Matrimonio y cortejo ponderan las condiciones de Venus y evitan Venus retrógrado.

Siembra y cosecha usan preferencias de Luna creciente/menguante y mansiones lunares.

Toda actividad está documentada en el endpoint /glossary/activities con sinónimos.

34 actividades predefinidas con reglas de seguridad y pesos de factores específicos para cada una

1 min read

¿Cómo funciona el motor de puntuación por dentro?

Cada actividad predefinida define 31 factores con pesos individuales que suman 100.

Para cada momento candidato, cada evaluador de factor devuelve una puntuación de cumplimiento (0.0-1.0), una cadena de observación y detalles opcionales.

Estos cumplimientos brutos pasan por curvas de saturación (configurables por actividad) antes de agregarse con sus pesos en una puntuación final de 0-100, asignada a una calificación: excelente (90-100), bueno (75-89), aceptable (60-74), precaución (40-59), malo (0-39).

Los bloqueos absolutos se comprueban por separado mediante 23 verificadores dedicados: eclipses, planetas retrógrados, Luna vacía de curso, planetas combustos, maléfico en ángulo, comprobaciones de planeta en cúspide y condiciones específicas de la actividad como la Luna en signo por zona del cuerpo para cirugía y odontología.

Un momento bloqueado queda excluido por completo con una explicación.

Además de los verificadores integrados, puedes pasar tus propios filtros de criterios estrictos (moon_waxing, planet_dignified, planet_angular) que toda ventana devuelta debe satisfacer, convirtiendo preferencias suaves de puntuación en filtros innegociables.

Cada ventana lleva también combust_flags por significador, de modo que puedes detectar y descartar significadores combustos.

Si se proporciona una carta natal, un modificador natal (limitado a más o menos 20%) ajusta la puntuación universal, y el detector PersonalAdvisory hace aflorar tránsitos importantes como el retorno de Saturno aun cuando la puntuación universal sea alta.

31 factores con curvas de saturación + 23 verificadores de bloqueo absoluto por momento

2 min read

¿Qué devuelve ahora cada ventana puntuada?

Dos mejoras en la respuesta hacen que los momentos recomendados sean autocontenidos y explicables.

Primero, cada ventana puntuada lleva body_positions: las posiciones planetarias completas (signo, grado y casa) en ese momento exacto.

Renderizas la carta de cualquier momento recomendado directamente desde la respuesta de search o evaluate, sin una segunda llamada a la API: el mismo payload impulsa tanto la puntuación 0-100 como la rueda que dibujas en tu interfaz.

Segundo, cada ventana ahora nombra sus key_significators: los planetas y regentes concretos que el motor realmente puntuó para esa actividad.

Una ventana de matrimonio hace aflorar los regentes de Venus y la Luna que pesó; una ventana de cirugía hace aflorar los cuerpos que importaron para el procedimiento.

Así muestras a los usuarios por qué un momento se clasifica donde lo hace en lugar de un número pelado.

La puntuación también gradúa ahora la combustión por gravedad y rol, no una simple bandera de sí/no: un significador primario combusto baja la puntuación mucho más que un cuerpo combusto incidental, así que las clasificaciones reflejan cuánto importa de verdad la combustión para esa actividad.

body_positions + key_significators en cada ventana, con combustión graduada por rol

1 min read

¿Cómo integro la API electiva?

REST estándar.

Envía un POST a /api/v3/electional/search con tu actividad, rango de fechas y ubicación.

Recibes JSON con heatmap, top_windows, excluded_ranges y summary.

Para comprobaciones de un solo momento, haz POST a /evaluate.

Para menús desplegables de la interfaz o detección de intención por LLM, GET /glossary/activities devuelve las 34 actividades con sinónimos.

Parámetros opcionales: natal_chart para puntuación personalizada, filters para restricciones por hora del día y día de la semana, granularity (1m/5m/15m/1h/4h/1d) para la precisión de las ventanas, language para el texto de razonamiento (en, ru, de, es, fr, it, pt, zh, hi), summary_mode para una salida compacta adaptada a LLM, emergency_mode para cirugía cuando el procedimiento no puede esperar.

La API está diseñada para ser invocable por MCP: la herramienta find_best_time ya está registrada para la integración con agentes de IA.

3 endpoints, lista para MCP, summary_mode adaptado a LLM

1 min read

¿Quién usa la API de Astrología Electiva?

Cinco segmentos principales: (1) Desarrolladores de apps de astrología que crean funciones de momentos óptimos: el mapa de calor y las ventanas puntuadas son datos de interfaz listos para renderizar, y las 34 actividades cubren casi cualquier pregunta del tipo 'mejor momento para X' que hagan los usuarios.

(2) Plataformas de bodas y eventos que añaden recomendaciones de fechas: las actividades de matrimonio y boda gestionan automáticamente Venus Rx, eclipses, Luna vacía de curso y el retorno de Saturno.

(3) Apps de salud y bienestar: las actividades de cirugía y odontología imponen la seguridad de la Luna en signo por zona del cuerpo, mientras que el corte de pelo, el procedimiento estético y los momentos para la medicación dan servicio a funciones cotidianas de autocuidado.

(4) Creadores de agentes de IA que usan herramientas MCP: la herramienta find_best_time funciona de inmediato con la invocación de funciones de OpenAI/Anthropic.

(5) Astrólogos profesionales que escalan su práctica: en lugar de 1 a 4 horas por consulta, obtienen resultados puntuados al instante con justificantes de factores para revisar y presentar a los clientes.

La API se encarga del cálculo; el astrólogo aporta la experiencia y el trato personal.

1 min read

Use Cases

Apps de Planificación de Bodas y Eventos

Recomienda fechas de boda óptimas con análisis de Venus/Luna, aviso de retorno de Saturno y evitación de eclipses. Los justificantes de factores explican cada recomendación.

Integración con Agentes de IA (MCP)

Herramienta MCP find_best_time para ChatGPT, Claude y agentes de IA personalizados. El modo resumen devuelve JSON compacto para las ventanas de contexto del chat.

Herramientas de Programación de Cirugías

Seguridad hipocrática con 15 zonas del cuerpo. Aplicación de la regla de la Luna en signo. Anulación con modo emergencia y texto de aviso obligatorio.

Plataformas de Lanzamiento de Negocios

Evitación de Mercurio retrógrado, exclusión de Luna vacía de curso y optimización de aspectos de Júpiter para los momentos de negocio.

Paneles para Astrólogos Profesionales

Los justificantes factor por factor permiten a los astrólogos verificar y presentar resultados puntuados a sus clientes. De 1 a 4 horas de trabajo en menos de 2 segundos.

Momentos Inmobiliarios y Legales

Optimización de firma de contratos, compra de propiedades, alquiler, mudanza, reubicación y asentamiento con actividades predefinidas específicas.

Apps de Salud y Autocuidado

Seguridad por zona del cuerpo para odontología (dientes/mandíbula) y cirugía, además de momentos cotidianos para corte de pelo, procedimiento estético, medicación y destete.

Apps de Relaciones y Eventos Vitales

Matrimonio, cortejo, divorcio, concepción, parto e imposición de nombre, cada uno con factores de Venus, Luna y área de vida ajustados.

Apps de Agricultura y Jardinería

Momentos de siembra y cosecha usando preferencias de Luna creciente/menguante y mansiones lunares para la fertilidad y el rendimiento.

Herramientas de Carrera y Trabajo

Mejores momentos para exámenes, entrevistas, sesiones de estudio, contrataciones y despidos: las 34 actividades cubren toda la jornada laboral.

Technical Specifications

Endpoints	3 (search, evaluate, glossary)
Rango de Puntuación	0-100 numérico con curvas de saturación
Actividades Predefinidas	34 (cirugía, matrimonio, negocios, siembra, corte de pelo, etc.)
Calificaciones	excelente 90-100, bueno 75-89, aceptable 60-74, precaución 40-59, malo 0-39
Idiomas	9 (en, ru, de, es, fr, it, pt, zh, hi)
Evaluadores de Factores	31 evaluaciones por factor en cada momento
Verificadores de Bloqueo Absoluto	23 verificadores de exclusión dedicados
Rango de Búsqueda	Hasta 367 días por solicitud
Velocidad de Búsqueda	<2s para búsqueda de 90 días (p95)
Velocidad de Evaluación	<300ms para puntuar un solo momento
Granularidad	1m / 5m / 15m / 1h / 4h / 1d configurable
Seguridad Cirugía y Odontología	Regla de Luna en signo por zona del cuerpo (15 zonas)
Aviso Personal	Retorno de Saturno, tránsitos duros de planetas exteriores a la carta natal
Salida	Mapa de calor + ventanas ordenadas + rangos excluidos + razonamiento en lenguaje natural
Detalle por Ventana	Posiciones de carta + significadores puntuados por ventana
Integración MCP	Herramienta find_best_time registrada
Efemérides	Swiss Ephemeris JPL DE431
Caché	Pool Redis por bucle de eventos, TTL de 24h, aceleración 430x en caliente

API Electiva vs Competidores

Feature	Astrology API	Others
Puntuación Electiva Occidental	Numérica 0-100	Ninguna (Solar Fire: booleana, Védica: binaria)
Mapa de Calor por Calendario	Graduado día a día	No disponible
Desglose de Factores	31 factores con justificantes	No disponible
Razonamiento en Lenguaje Natural	Texto por ventana en inglés	No disponible
Actividades Predefinidas	34 con pesos ajustados	KundliAPI: 9 (solo védicas, sin puntuaciones)
Acceso por API	API REST JSON	Solo escritorio o API solo védica
Rango de Búsqueda	Hasta 367 días	Máximo 90 días (herramientas web)
Seguridad en Cirugía	Regla hipocrática de 15 zonas	No disponible
Listo para MCP/LLM	Herramienta integrada + summary_mode	No disponible
Precio	Desde $11/mes	$300-700/mes (software de escritorio)

API de Astrología Relacionadas

Transit API

Tránsitos planetarios en tiempo real que impulsan los evaluadores de factores electivos

Planetary Hours API

Horas planetarias tradicionales: uno de los 31 factores electivos

Horary API

Astrología basada en preguntas que comparte el mismo motor de cálculo

Natal Chart API

Cartas natales para la puntuación electiva personalizada

Documentación de la API

Referencia completa de endpoints con ejemplos de solicitud/respuesta

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

Precios Simples y Transparentes

Comienza gratis, escala a medida que creces. Sin cargos ocultos.

Siempre Gratis

Sin Tarjeta de Credito

Perfecto para aprender, probar y proyectos personales pequenos

50 llamadas API/mes

Cartas natales basicas

5 sistemas de casas

Soporte comunitario

Pro

$11/mes

Para apps pequenas y proyectos personales

Todos los endpoints basicos
12 sistemas de casas
Soporte por email

Mejor Valor

Pro Plus

$21/mes

Para apps en crecimiento y trafico medio

Todos los endpoints mejorados
18 sistemas de casas
Interpretaciones con IA
Soporte email prioritario

Ultra

$37/mes

Para aplicaciones de astrologia profesionales

Credit math ↓

Todos los endpoints premium
23 sistemas de casas
Interpretaciones IA avanzadas
Soporte prioritario

Planes de Alto Volumen

Para aplicaciones a escala empresarial

Business

$99/mes

Para aplicaciones de alto volumen

Credit math ↓

TODOS los endpoints
Listo para marca blanca
Ajuste fino de IA personalizado
Soporte telefonico

ILIMITADO

Enterprise

$399+por mes

Peticiones ilimitadas con infraestructura dedicada

Infraestructura de servidor dedicado
Sub-300ms garantizado
Soporte dedicado 24/7
99.99% uptime SLA

Todos los planes incluyen documentacion completa y SDKs

Preguntas? Habla con nuestro equipo

Preguntas Frecuentes Sobre la API de Astrología Electiva

Respuestas técnicas para desarrolladores que crean funciones de momentos óptimos

Completa tu Stack de Momentos Astrológicos

La API electiva funciona mejor combinada con nuestras otras herramientas de momentos óptimos y cálculo.

Transit API Planetary Hours Horary API Natal Chart API Lunation API

Empieza a Encontrar

Primera API REST de astrología electiva occidental. Puntuación 0-100, 34 actividades predefinidas, justificantes de factores, 9 idiomas. Ningún competidor lo tiene.

Empieza Gratis Ver Documentación

50 solicitudes gratuitas/mes

Precisión Swiss Ephemeris

Sin tarifas de configuración

El plan gratuito incluye todas las funciones

Encuentra el Mejor Momento para Cualquier Cosa. Puntuado 0-100.

No Existe Ninguna API Electiva Occidental

Primera API REST Electiva Diseñada para Este Fin

Rendimiento de la API Electiva

Funciones Completas de Astrología Electiva

Búsqueda por Rango de Fechas

Evaluación de un Solo Momento

34 Actividades Predefinidas

Motor de Puntuación

Integración con IA y LLM

Calificaciones y Localización

Ventanas Listas para Carta

Puntuación Explicable

¿Qué Es la API de Astrología Electiva? Guía Completa para Desarrolladores

¿Cómo funciona la API de Astrología Electiva?

¿Qué hace única a esta API electiva?

¿Qué actividades admite la API electiva?

¿Cómo funciona el motor de puntuación por dentro?

¿Qué devuelve ahora cada ventana puntuada?

¿Cómo integro la API electiva?

¿Quién usa la API de Astrología Electiva?

Use Cases

Apps de Planificación de Bodas y Eventos

Integración con Agentes de IA (MCP)

Herramientas de Programación de Cirugías

Plataformas de Lanzamiento de Negocios

Paneles para Astrólogos Profesionales

Momentos Inmobiliarios y Legales

Apps de Salud y Autocuidado

Apps de Relaciones y Eventos Vitales

Apps de Agricultura y Jardinería

Herramientas de Carrera y Trabajo

Technical Specifications

API Electiva vs Competidores

API de Astrología Relacionadas

Transit API

Planetary Hours API

Horary API

Natal Chart API

Documentación de la API

References & Standards

Precios Simples y Transparentes

Siempre Gratis

Pro

Pro Plus

Ultra

Planes de Alto Volumen

Business

Enterprise

Preguntas Frecuentes Sobre la API de Astrología Electiva

¿Qué es la astrología electiva y cómo la automatiza esta API?

¿Qué la diferencia de las API védicas de muhurta como Prokerala o KundliAPI?

¿Cuánto cuesta la API de Astrología Electiva?

¿Qué tan rápida es la búsqueda electiva para rangos de fechas grandes?

¿Qué actividades y eventos admite la API electiva?

¿Cómo funciona la regla de seguridad por zona del cuerpo para cirugía y odontología?

¿Qué es el mapa de calor por calendario y cómo lo uso?

¿Qué son los justificantes de factores y por qué importan?

¿Cómo integro la API electiva en mi aplicación?

¿Puedo usarla con agentes de IA y LLM?

¿Qué es el aviso personal y cómo funciona la entrada de carta natal?

¿Qué bloqueos absolutos comprueba el motor electivo?

¿Qué tan precisos son los cálculos astronómicos?

¿Puedo filtrar los resultados de búsqueda por hora del día o día de la semana?

¿Qué lenguajes de programación funcionan con la API electiva?

¿Hay un plan gratuito para la API electiva?

¿Cómo gestiona la actividad de boda a Venus retrógrado?

¿Puedo usar la API para los momentos de lanzamiento de un negocio?

¿Cómo puntúan los momentos de matrimonio, cortejo y divorcio?

¿Puedo encontrar el mejor momento para un corte de pelo o un procedimiento estético?

¿La API admite los momentos de siembra y cosecha para la agricultura?

¿Qué calificaciones devuelve la API junto con la puntuación?

¿Qué idiomas admite el texto de razonamiento?

¿Puedo controlar la precisión de las ventanas candidatas?

¿Las 34 actividades predefinidas están revisadas por astrólogos reales?

¿Puedo imponer mis propias reglas estrictas, como "la Luna debe estar creciente"?

¿Marcáis los planetas combustos en la ventana elegida?

¿Puedo renderizar la carta de un momento recomendado sin una segunda llamada?

¿Cómo sé por qué un momento puntuó bien?

Completa tu Stack de Momentos Astrológicos