Astraluno Lunations API
The Lunations API from Astraluno — 1 operation(s) for lunations.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/astraluno-com:astraluno-com-lunations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Astraluno public Lunations API
version: 1.0.0
description: Read-only astrology computations. No birth data is stored or logged. 60 compute requests/min/IP; 120 light requests/min/IP. No keys. Free corpus.
servers:
- url: https://astraluno.com
tags:
- name: Lunations
paths:
/api/v1/lunations:
get:
operationId: lunations
summary: lunations
description: Read-only, free, no API key. Tropical, geocentric, Whole Sign. No birth data is stored or logged; request bodies and queries never enter logs or stats. Angular numbers also have D°MM′ strings in degree_strings (JSON pointers). Respect uncertainty windows and all sign possibilities. Dates include the IANA timezone used.
parameters:
- name: lang
in: query
required: false
schema:
default: en
description: 'Language code. Published: en, it. Other codes fall back to English with a language.note.'
type: string
maxLength: 35
- name: from
in: query
required: true
schema:
type: string
format: date
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
example: '2027-01-01'
- name: to
in: query
required: true
schema:
type: string
format: date
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
example: '2027-02-01'
- name: timezone
in: query
required: false
schema:
default: UTC
type: string
minLength: 1
maxLength: 100
pattern: ^[A-Za-z0-9_+-]+(?:\/[A-Za-z0-9_+-]+)*$
example: Europe/Rome
responses:
'200':
description: Computed result with source and citation URL
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
language:
type: object
properties:
requested:
type: string
effective:
type: string
enum:
- en
- es
- fr
- it
note:
type:
- string
- 'null'
required:
- requested
- effective
- note
additionalProperties: false
source:
type: string
const: Astraluno
url:
type: string
format: uri
timezone:
anyOf:
- type: string
minLength: 1
maxLength: 100
pattern: ^[A-Za-z0-9_+-]+(?:\/[A-Za-z0-9_+-]+)*$
- type: 'null'
degree_strings:
type: object
propertyNames:
type: string
additionalProperties:
type: string
description: D°MM′ strings keyed by JSON pointer to every angular number in this response, including ranges. The engine snapshot is unchanged.
from:
type: string
format: date
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
to:
type: string
format: date
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
events:
type: array
items:
type: object
properties:
type:
type: string
enum:
- new
- first-quarter
- full
- last-quarter
at:
type: object
properties:
utc:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
uncertaintyMinutes:
anyOf:
- type: number
minimum: 0
- type: 'null'
precisionHint:
type: string
enum:
- time
- date
- window
uncertaintyMethod:
type: string
enum:
- angular-over-speed
- station-curvature
- unbounded
windowFromUtc:
anyOf:
- type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
- type: 'null'
windowToUtc:
anyOf:
- type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
- type: 'null'
local:
type: object
properties:
utc:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
local:
type: string
timezone:
type: string
minLength: 1
maxLength: 100
pattern: ^[A-Za-z0-9_+-]+(?:\/[A-Za-z0-9_+-]+)*$
offsetSec:
type: number
required:
- utc
- local
- timezone
- offsetSec
additionalProperties: false
windowFromLocal:
anyOf:
- type: object
properties:
utc:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
local:
type: string
timezone:
type: string
minLength: 1
maxLength: 100
pattern: ^[A-Za-z0-9_+-]+(?:\/[A-Za-z0-9_+-]+)*$
offsetSec:
type: number
required:
- utc
- local
- timezone
- offsetSec
additionalProperties: false
- type: 'null'
windowToLocal:
anyOf:
- type: object
properties:
utc:
type: string
format: date-time
pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
local:
type: string
timezone:
type: string
minLength: 1
maxLength: 100
pattern: ^[A-Za-z0-9_+-]+(?:\/[A-Za-z0-9_+-]+)*$
offsetSec:
type: number
required:
- utc
- local
- timezone
- offsetSec
additionalProperties: false
- type: 'null'
required:
- utc
- uncertaintyMinutes
- precisionHint
- uncertaintyMethod
- windowFromUtc
- windowToUtc
- local
- windowFromLocal
- windowToLocal
additionalProperties: false
sign:
type: string
enum:
- aries
- taurus
- gemini
- cancer
- leo
- virgo
- libra
- scorpio
- sagittarius
- capricorn
- aquarius
- pisces
degreeInSign:
type: number
phaseAngle:
type: number
required:
- type
- at
- sign
- degreeInSign
- phaseAngle
additionalProperties: false
required:
- language
- source
- url
- timezone
- degree_strings
- from
- to
- events
additionalProperties: false
'400':
description: Structured validation, engine or rate-limit error. Birth data is never stored or logged.
headers:
Retry-After:
description: Seconds until retry (429)
schema:
type: integer
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
details:
anyOf:
- {}
- type: 'null'
required:
- code
- message
- details
additionalProperties: false
required:
- error
additionalProperties: false
'404':
description: Structured validation, engine or rate-limit error. Birth data is never stored or logged.
headers:
Retry-After:
description: Seconds until retry (429)
schema:
type: integer
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
details:
anyOf:
- {}
- type: 'null'
required:
- code
- message
- details
additionalProperties: false
required:
- error
additionalProperties: false
'413':
description: Structured validation, engine or rate-limit error. Birth data is never stored or logged.
headers:
Retry-After:
description: Seconds until retry (429)
schema:
type: integer
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
details:
anyOf:
- {}
- type: 'null'
required:
- code
- message
- details
additionalProperties: false
required:
- error
additionalProperties: false
'415':
description: Structured validation, engine or rate-limit error. Birth data is never stored or logged.
headers:
Retry-After:
description: Seconds until retry (429)
schema:
type: integer
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
details:
anyOf:
- {}
- type: 'null'
required:
- code
- message
- details
additionalProperties: false
required:
- error
additionalProperties: false
'429':
description: Structured validation, engine or rate-limit error. Birth data is never stored or logged.
headers:
Retry-After:
description: Seconds until retry (429)
schema:
type: integer
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
details:
anyOf:
- {}
- type: 'null'
required:
- code
- message
- details
additionalProperties: false
required:
- error
additionalProperties: false
'500':
description: Structured validation, engine or rate-limit error. Birth data is never stored or logged.
headers:
Retry-After:
description: Seconds until retry (429)
schema:
type: integer
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
details:
anyOf:
- {}
- type: 'null'
required:
- code
- message
- details
additionalProperties: false
required:
- error
additionalProperties: false
tags:
- Lunations