Secondary Progressions API
Generate a progressed chart with an explicit time mapping. One ephemeris day represents one Julian year of life, and the response exposes both the target date and the derived ephemeris instant.
POST /v1/astrology/progressions50,000 credits per monthly allowance · no trial · no automatic overage charges. Plan details ↗
What this API provides.
Calculate a secondary progressed chart using one ephemeris day per Julian year. Return the progressed instant, planets, houses and aspects in JSON.
A declared year length of 365.25 days
Progressed planets, aspects and selected house system
A separate progressed-chart interpretation context
Send
- A known-time birth object with coordinates
- at as an offset-aware target timestamp after birth
- Optional house_system and locale
Receive
- method: secondary_day_for_julian_year
- at, progressed_instant and year_days
- chart with calculated positions, houses and aspects
See the calculated chart.
The original renderer uses the exact positions in this example. These are computed charts, not stock diagrams. JSON remains the authoritative source.
Real input. Real output.
Precomputed by the actual calculation engine and response formatter, using synthetic example data. No purchased access or paid provider call was needed.
{
"locale": "en",
"birth": {
"date": "1990-05-21",
"time": "14:30:00",
"timezone": "Europe/Madrid",
"latitude": 40.4168,
"longitude": -3.7038
},
"at": "2026-11-17T12:00:00Z"
}{
"request_id": "0e57ebbd1a339fb06820c0cd154ad1ae",
"api_version": "v1",
"locale": "en",
"data": {
"method": "secondary_day_for_julian_year",
"at": "2026-11-17T12:00:00Z",
"progressed_instant": "1990-06-27T00:19:34Z",
"year_days": 365.25,
"chart": {
"birth_time_known": true,
"at": "1990-06-27T00:19:34Z",
"planets": {
"sun": {
"longitude": 95.12094834,
"latitude": -0.00003801,
"distance_au": 1.0165398601,
"sign": "cancer"
},
"moon": {
"longitude": 150.90126319,
"latitude": -2.06227199,
"distance_au": 0.0025527078,
"sign": "virgo"
},
"mercury": {
"longitude": 88.1712476,
"latitude": 0.4764023,
"distance_au": 1.2921041275,
"sign": "gemini"
},
"venus": {
"longitude": 62.37364577,
"latitude": -1.66170598,
"distance_au": 1.3273893777,
"sign": "gemini"
}
},
"houses": {
"system": "whole_sign",
"ascendant": 10.40924271,
"midheaven": 275.55240628,
"cusps": [
0
]
},
"aspects": [
{
"body1": "mars",
"body2": "jupiter",
"aspect": "square",
"angle": 90
},
{
"body1": "moon",
"body2": "venus",
"aspect": "square",
"angle": 90
}
],
"warnings": []
}
},
"interpretation": {
"locale": "en",
"kind": "astrology/progressions",
"disclaimer": "Symbolic reflection, not a verified prediction or professional advice.",
"coverage": {
"total_facts": 24,
"selected_facts": 24,
"omitted_count": 0,
"selection_method": "all-source-facts-v1",
"full_numeric_data_unchanged": true
},
"method": {
"engine": "celestack-original-rules-v1",
"corpus": "celestack-original-compositional-v1",
"corpus_version": "2026-11-17.2",
"fallback_locale": null,
"editorial_status": "agent-authored; independent linguistic review pending",
"predictive_validity": "symbolic interpretations are not scientifically validated predictions",
"chinese_solar_terms": "numeric calendar output only; no rule paragraphs in this corpus"
},
"items": [
{
"fact_id": "astrology/progressions.chart.planets.sun",
"title": "Progressed chart · Sun · Cancer",
"text": "Context: Progressed chart. Sun · Cancer · 5.12095° within the sign. Zodiac: tropical. Symbolic focus: self-expression and direction. Consider what creates a sense of belonging and safety. House 4: home, roots and private space. Apply the reflection to a real situation rather than a fixed outcome. Reference time: 1990-06-27T00:19:34Z.",
"source": {
"longitude": 95.12094834,
"latitude": -0.00003801,
"distance_au": 1.0165398601,
"sign": "cancer",
"sign_degree": 5.12094834,
"speed_deg_per_day": 0.95396604,
"retrograde": false,
"house": 4,
"id": "astrology/progressions.chart.planets.sun",
"type": "astro_placement",
"planet": "sun",
"frame": "tropical",
"at": "1990-06-27T00:19:34Z",
"context": [
"progressed_chart"
]
}
}
]
},
"warnings": [],
"credits_used": 5
}The response preview selects whole fields and array entries for readability; no numeric values have been replaced. The full download preserves all fields, arrays and interpretation. The request_id is synthetic, and credits_used shows the configured successful-request cost; no credits were consumed.
cURL request — use your own API key and a new idempotency key
curl --request POST 'https://api.celestackapi.com/v1/astrology/progressions' \
+ --header 'Authorization: Bearer YOUR_API_KEY' \
+ --header 'Content-Type: application/json' \
+ --header 'Idempotency-Key: secondary-progressions-api-example-001' \
+ --data '{
"locale": "en",
"birth": {
"date": "1990-05-21",
"time": "14:30:00",
"timezone": "Europe/Madrid",
"latitude": 40.4168,
"longitude": -3.7038
},
"at": "2026-11-17T12:00:00Z"
}'Example computed 2026-11-17. Full fixture manifest, engine versions and SHA-256 checksums ↗
Ways to use it.
- Progressed chart timelines
- Comparing natal and progressed placements in your interface
- A documented calculation basis for reflective content
12 response locales
English, Ukrainian, Japanese, Spanish, French, German, Portuguese, Arabic, Italian, Hindi, Chinese and Korean.
Calculation values remain language-independent. Localized rule text is agent-authored; independent native-language review remains pending. Machine-readable field names stay stable.
Limits and interpretation.
- This is secondary progression, not a solar-arc direction or primary direction.
- The target instant must not precede birth, and the supported date bounds apply.
- The chart uses the declared profile at the birth location; alternate progressed-angle schools are not selectable.
Interpretive content is for symbolic reflection and entertainment. It is not a verified personal prediction or professional advice. Read the API conventions ↗
Choose your billing.
Both options include 50,000 credits per monthly allowance, resetting monthly. No trial and no automatic overage. Custom needs use a contact form.
Saved results: 7-day retention, up to 128 MiB per organization on this initial shared deployment, with a 512 MiB shared retained-result limit. Capacity can return a temporary error; there are no automatic extra charges. Production artifacts have separate retention. All usage and resource limits ↗. Checkout availability is shown in your account.
Frequently asked questions.
What year length does the calculation use?
It uses a Julian year of 365.25 days. The progressed ephemeris instant equals birth plus elapsed real time divided by 365.25.
Are solar-arc directions included?
No. This endpoint implements the documented secondary day-for-year profile. It does not silently substitute another progression or direction system.
Can I see the actual progressed instant?
Yes. progressed_instant is returned next to the requested at timestamp, so the time mapping is directly inspectable.
What does access cost?
Access is USD 39.99 per month or USD 199 billed annually, with no trial. Both billing options provide 50,000 credits per monthly allowance. 5 credits per successful request or job. Daily credit, attempt, rate and resource limits apply. There are no automatic overage charges.