Astroletra Cielo API

The Cielo API from Astroletra — 1 operation(s) for cielo.

GitHub OpenAPI

Operations 1

GET /api/v1/cielo Cielo de un día en una zona horaria #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/astroletra-com:astroletra-com-cielo-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

astroletra-com-cielo-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Astroletra Com Cielo API
  version: 1.1.0
  contact:
    name: Astroletra
    email: info@astroletra.com
    url: https://astroletra.com/datos/api/
  license:
    name: CC BY 4.0
    url: https://creativecommons.org/licenses/by/4.0/
  description: 'Operations tagged Cielo across 2 of this provider''s published API definitions: astroletra-com-openapi.json, astroletra-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.astroletra.com
tags:
- name: Cielo
paths:
  /api/v1/cielo:
    get:
      operationId: cielo
      summary: Cielo de un día en una zona horaria
      parameters:
      - name: date
        in: query
        required: false
        description: Día civil AAAA-MM-DD, a ±7 días de hoy en la zona pedida. Por defecto, hoy.
        schema:
          type: string
          format: date
      - name: tz
        in: query
        required: false
        description: Zona IANA de la lista admitida (España y las capitales de los países hispanohablantes, entre otras), p. ej. America/Mexico_City. Por defecto, Europe/Madrid. Otra zona devuelve 422.
        schema:
          type: string
          default: Europe/Madrid
          enum:
          - Europe/Madrid
          - Atlantic/Canary
          - Europe/London
          - Europe/Paris
          - Europe/Berlin
          - America/Mexico_City
          - America/Guatemala
          - America/El_Salvador
          - America/Tegucigalpa
          - America/Managua
          - America/Costa_Rica
          - America/Panama
          - America/Havana
          - America/Santo_Domingo
          - America/Puerto_Rico
          - America/Bogota
          - America/Caracas
          - America/Guayaquil
          - America/Lima
          - America/La_Paz
          - America/Santiago
          - America/Argentina/Buenos_Aires
          - America/Asuncion
          - America/Montevideo
          - America/New_York
          - America/Chicago
          - America/Los_Angeles
          - America/Sao_Paulo
      responses:
        '200':
          description: Cielo del día
          headers:
            Cache-Control:
              schema:
                type: string
              description: public, max-age=3600 (86400 en fechas pasadas, que no cambian)
            Access-Control-Allow-Origin:
              schema:
                type: string
              description: '*'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Cielo'
              example:
                date: '2026-11-24'
                tz: Europe/Madrid
                moon:
                  sign: Taurus
                  sign_label: Tauro
                  degree: 29.9
                  phase: Full Moon
                  illumination: 1.0
                  changes_sign_today: true
                  next_sign_change:
                    at_local: 2026-11-24T12:09+01:00
                    time: '12:09'
                    date_local: '2026-11-24'
                    to_sign: Gemini
                    to_sign_label: Géminis
                    from_sign: Taurus
                  sign_change:
                    at_local: 2026-11-24T12:09+01:00
                    time: '12:09'
                    date_local: '2026-11-24'
                    to_sign: Gemini
                    to_sign_label: Géminis
                retrogrades:
                - planet: Saturn
                  planet_label: Saturno
                  sign: Aries
                  sign_label: Aries
                  since: '2026-07-26'
                  until: '2026-12-10'
                  shadow_to: '2027-03-15'
                - planet: Uranus
                  planet_label: Urano
                  sign: Gemini
                  sign_label: Géminis
                  since: '2026-09-10'
                  until: '2027-02-08'
                  shadow_to: null
                - planet: Neptune
                  planet_label: Neptuno
                  sign: Aries
                  sign_label: Aries
                  since: '2026-07-07'
                  until: '2026-12-12'
                  shadow_to: null
                next_lunation:
                  phase: full
                  at_local: 2026-11-24T15:53+01:00
                  date_local: '2026-11-24'
                  sign: Gemini
                  sign_label: Géminis
                source: Astroletra — https://astroletra.com
                license: CC BY 4.0
                license_url: https://creativecommons.org/licenses/by/4.0/
                ephemeris: JPL DE440 (NASA), zodiaco tropical, geocéntrico
                docs: https://astroletra.com/datos/api/
                aspects:
                - p1: Sun
                  p2: Neptune
                  p1_label: Sol
                  p2_label: Neptuno
                  type: trine
                  type_label: trígono
                  exact: true
                  at_local: 2026-11-24T01:07+01:00
                  time: 01:07
                  orb: 0.0
                - p1: Moon
                  p2: Jupiter
                  p1_label: Luna
                  p2_label: Júpiter
                  type: square
                  type_label: cuadratura
                  exact: true
                  at_local: 2026-11-24T06:28+01:00
                  time: 06:28
                  orb: 0.0
                planets:
                - name: Sun
                  name_label: Sol
                  sign: Sagittarius
                  sign_label: Sagitario
                  degree: 2.17
                  retrograde: false
                - name: Moon
                  name_label: Luna
                  sign: Taurus
                  sign_label: Tauro
                  degree: 29.9
                  retrograde: false
        '422':
          description: Zona o fecha no válidas
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Demasiadas peticiones (más de 60 por minuto); mira Retry-After
          headers:
            Retry-After:
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Cálculo no disponible en este momento
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Cielo
    servers:
    - url: https://api.astroletra.com
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
        details:
          type:
          - array
          - 'null'
          items:
            type: object
            properties:
              path:
                type: string
              message:
                type: string
      required:
      - error
    Cielo:
      type: object
      required:
      - date
      - tz
      - moon
      - aspects
      - retrogrades
      - source
      - license
      - ephemeris
      properties:
        date:
          type: string
          format: date
        tz:
          type: string
        moon:
          type: object
          properties:
            sign:
              type: string
            sign_label:
              type: string
            degree:
              type: number
              description: Grado dentro del signo (0-30)
            phase:
              type:
              - string
              - 'null'
            illumination:
              type:
              - number
              - 'null'
              minimum: 0
              maximum: 1
            changes_sign_today:
              type: boolean
            next_sign_change:
              type:
              - object
              - 'null'
              properties:
                at_local:
                  type: string
                time:
                  type: string
                date_local:
                  type: string
                to_sign:
                  type: string
                to_sign_label:
                  type: string
        planets:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              name_label:
                type: string
              sign:
                type: string
              sign_label:
                type: string
              degree:
                type: number
              retrograde:
                type: boolean
        aspects:
          type: array
          items:
            type: object
            properties:
              p1:
                type: string
              p2:
                type: string
              p1_label:
                type: string
              p2_label:
                type: string
              type:
                type: string
              type_label:
                type: string
              exact:
                type: boolean
              at_local:
                type:
                - string
                - 'null'
              time:
                type:
                - string
                - 'null'
              orb:
                type: number
        retrogrades:
          type: array
          items:
            type: object
            properties:
              planet:
                type: string
              planet_label:
                type: string
              sign:
                type: string
              sign_label:
                type: string
              since:
                type:
                - string
                - 'null'
              until:
                type:
                - string
                - 'null'
              shadow_to:
                type:
                - string
                - 'null'
        lunation_today:
          type:
          - object
          - 'null'
        next_lunation:
          type:
          - object
          - 'null'
          properties:
            phase:
              type: string
              enum:
              - new
              - full
            at_local:
              type: string
            date_local:
              type: string
            sign:
              type: string
            sign_label:
              type: string
        source:
          type: string
        license:
          type: string
        license_url:
          type: string
        ephemeris:
          type: string
        docs:
          type: string
        generated_at:
          type: string
x-refined-from:
- astroletra-com-openapi.json
- astroletra-com-openapi.yml