Astraluno Readings API
The Readings API from Astraluno — 1 operation(s) for readings.
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-readings-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 Readings 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: Readings
paths:
/api/v1/readings/{kind}/{key}:
get:
operationId: readings__kind___key_
summary: readings/{kind}/{key}
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: kind
in: path
required: true
schema:
type: string
enum:
- body
- angle
- sign
- house
- aspect
- element
- modality
- body-in-sign
- body-in-house
- ascendant-in-sign
example: body-in-sign
- name: key
in: path
required: true
schema:
type: string
minLength: 1
maxLength: 80
pattern: ^[a-z0-9-]+$
example: venus-in-leo
- 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
example: en
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.
reading:
type: object
properties:
kind:
type: string
key:
type: string
title:
type: string
oneLiner:
type: string
sections:
type: object
propertyNames:
type: string
additionalProperties:
type: string
url:
type: string
format: uri
required:
- kind
- key
- title
- oneLiner
- sections
- url
additionalProperties: false
required:
- language
- source
- url
- timezone
- degree_strings
- reading
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:
- Readings