Progressions API
진행 차트(Progressions)는 출생 이후 시간의 흐름에 따른 내적 성장과 발달을 분석합니다. 2차 진행법(Secondary Progressions)은 "하루가 1년"의 원리를 사용하여, 출생 후 34일째 되는 날의 행성 위치가 34세 때의 내적 상태를 나타낸다고 봅니다.
진행 차트 계산
/v1/astrology/progressionsPredictive특정 날짜의 2차 진행 차트와 네이탈 차트와의 애스펙트를 계산합니다.
2차 진행법(Secondary Progressions)이란?
2차 진행법은 가장 널리 사용되는 예측 기법 중 하나로, 출생 이후의 시간 흐름을 상징적으로 표현합니다. 기본 원리는 다음과 같습니다:
- 하루 = 1년: 출생 후 1일이 인생의 1년을 상징
- 내적 발달: 트랜짓이 외부 사건이라면, 진행은 내면의 성숙과 변화
- 느린 변화: 진행된 태양은 1년에 약 1도만 이동 (30년에 한 별자리씩)
- 진행된 달: 약 2.5년에 한 별자리씩 이동하며 감정적 주기를 나타냄
계산 예시
1990년 6월 15일에 태어난 사람의 34세(2024년 1월 15일) 진행 차트는, 출생 후 34일째인 1990년 7월 19일의 행성 위치를 사용합니다. 이는 34세 시점의 내적 심리 상태와 영적 발달 단계를 나타냅니다.
주요 진행 행성의 의미
| 행성 | 이동 속도 | 의미 |
|---|---|---|
| Progressed Sun | ~1°/년 | 정체성 발달, 인생 목적의 진화, 자아 의식의 성숙 |
| Progressed Moon | ~13°/월 | 감정 주기, 욕구의 변화, 약 2.5년마다 새로운 감정적 단계 (가장 빠르고 중요) |
| Progressed Mercury | ~1-2°/년 | 사고방식의 진화, 의사소통 스타일 변화, 학습 관심사 |
| Progressed Venus | ~1-1.2°/년 | 가치관 변화, 관계 패턴 진화, 미적 취향 발달 |
| Progressed Mars | ~0.5-0.6°/년 | 에너지 표현 방식, 욕망과 추진력의 진화 |
| 외행성 | 거의 정지 | 목성, 토성 등은 너무 느려서 진행에서 큰 의미가 없음 (네이탈 위치와 거의 동일) |
요청 파라미터
파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
natal_datetime | string | 필수 | 출생 날짜 및 시간 (ISO 8601 형식) 예시: |
natal_location | object | 필수 | 출생 위치 정보 |
natal_location.latitude | number | 필수 | 위도 (-90 ~ 90) 예시: |
natal_location.longitude | number | 필수 | 경도 (-180 ~ 180) 예시: |
natal_location.timezone | string | 선택 | IANA 타임존 (예: Asia/Seoul) - 미제공 시 좌표로 자동 감지 예시: |
target_datetime | string | 필수 | 진행 대상 날짜 및 시간 (ISO 8601 형식, natal_datetime 이후여야 함) 예시: |
target_location | object | 선택 | 진행 계산 위치 (기본값: 출생지 사용) |
progression_type | string | 선택 | 진행 타입 예시: 기본값: |
progression_method | string | 선택 | 진행법 방식 예시: 기본값: |
house_system | string | 선택 | 하우스 시스템 (PLACIDUS, WHOLE_SIGN, EQUAL 등) 예시: 기본값: |
include_aspects | boolean | 선택 | 진행 애스펙트 포함 여부 예시: 기본값: |
orb_degrees | number | 선택 | 애스펙트 오브 허용 범위 (0.5 ~ 10.0도) 예시: 기본값: |
name | string | 선택 | 차트 소유자 이름 예시: |
요청 예시
curl -X POST https://api.destinyapi.com/v1/astrology/progressions \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"natal_datetime": "1990-01-15T14:30:00",
"natal_location": {
"latitude": 37.5665,
"longitude": 126.978,
"timezone": "Asia/Seoul",
"elevation": 38
},
"target_datetime": "2025-01-15T12:00:00",
"target_location": {
"latitude": 37.5665,
"longitude": 126.978,
"timezone": "Asia/Seoul",
"elevation": 38
},
"progression_type": "secondary",
"progression_method": "day_for_year",
"house_system": "PLACIDUS",
"include_aspects": true,
"orb_degrees": 2,
"name": "John Doe"
}'타임존 자동 감지
natal_location.timezone을 제공하지 않으면 위도/경도 좌표를 기반으로 자동으로 타임존이 감지됩니다. 정확한 출생 시간대를 알고 있다면 명시적으로 제공하는 것을 권장합니다.
응답 구조
성공 응답 (200)
성공 응답
응답 필드 설명
- natal_chart: 출생 차트 기본 정보
chart_info: 차트 메타데이터name: 차트 이름datetime: 출생 날짜/시간location: {latitude, longitude, elevation}house_system: 하우스 시스템timezone: 타임존 (chart_info 최상위에 위치)
angles: 앵글 정보 (asc, mc 등 - 소문자 ID)longitude: 황경sign: 별자리dms: DMS 형식
bodies: 네이탈 행성 위치longitude: 황경latitude: 황위distance: 지구로부터 거리 (AU)sign: 별자리house: 하우스 번호retrograde: 역행 여부dms: DMS 형식speed: 일일 이동 속도
houses: 네이탈 하우스 정보 (house_1, house_2, ... house_12)cusp_longitude: 커스프 황경sign: 커스프 별자리bodies: 하우스 내 행성 ID 목록
aspects: 네이탈 애스펙트 목록body1,body2: 행성 IDaspect_type: 애스펙트 유형 (Title Case: Trine, Conjunction, Square 등)orb: 정확한 각도와의 차이exact: 정확한 각도 여부applying: 접근 중 여부
dignities: 디그니티 정보 (있는 경우)essential_dignities: 필수 디그니티 객체rulership: 지배 천체 (행성 이름, 예: 'Sun') 또는 nullexaltation: 고양 천체 (행성 이름) 또는 nulltriplicity: 트리플리시티 천체 (행성 이름) 또는 nullterm: 텀 천체 (행성 이름) 또는 nullface: 페이스 천체 (행성 이름) 또는 nulldetriment: 손상 천체 (행성 이름) 또는 nullfall: 하락 천체 (행성 이름) 또는 null
is_peregrine: 페러그린 여부 (엔진이 페러그린으로 판정하면 true)lilly_score: 릴리 점수 (디그니티 기반 계산값)
- progressed_chart: 진행된 차트 정보
chart_info: 진행 차트 메타데이터datetime: 진행 계산에 사용된 날짜 (출생일 + 대상 연령일수)name: 진행 차트 이름
bodies: 진행된 행성 위치longitude: 진행된 황경 (0-360도)sign: 진행된 별자리house: 진행된 하우스 번호dms: DMS 형식 위치
- progression_info: 진행 계산 정보
progression_type: 진행 타입 (secondary)natal_date: 출생 날짜target_date: 진행 대상 날짜progression_method: 진행 계산 방식 설명calculation_date: 계산 수행 시간
- progression_aspects: 진행 애스펙트
to_natal: 진행된 행성이 네이탈 행성과 이루는 애스펙트 목록body1: 진행된 행성 ID (소문자)body2: 네이탈 행성 ID (소문자)aspect_type: 애스펙트 유형orb: 정확한 각도와의 차이
- timestamp: 응답 생성 시간 (ISO 8601 형식)
- usage_info: API 사용량 정보
중요한 진행 애스펙트
| 애스펙트 | 의미 | 영향 기간 |
|---|---|---|
| Progressed Sun Conjunction Natal Venus | 사랑, 창의성, 자기 가치 발달의 시기 | ~2년 |
| Progressed Moon Conjunction Natal Sun | 새로운 시작, 감정과 의지의 통합 | ~2-3개월 |
| Progressed Sun Square Natal Mars | 도전, 에너지의 재조정, 행동 패턴 변화 | ~2년 |
| Progressed Moon through Houses | 각 하우스 주제에 대한 감정적 집중 (약 2.5년씩 한 하우스 통과) | 2.5년/하우스 |
| Progressed Sun Changes Sign | 인생의 주요 전환점, 정체성의 근본적 변화 | 30년마다 |
진행 애스펙트 해석 팁
진행 애스펙트는 매우 느리게 형성되므로 (태양의 경우 몇 년), 그 영향은 점진적이고 내적입니다. 트랜짓처럼 갑작스러운 사건보다는 의식의 변화, 태도의 진화, 내면의 성숙을 나타냅니다. 특히 진행된 태양이 별자리를 바꿀 때는 인생의 중대한 정체성 전환을 경험합니다.
에러 응답
잘못된 날짜 형식 (400)
날짜 형식 오류
{
"success": false,
"error": "Invalid value for 'body -> natal_datetime': Invalid datetime format. Use ISO format: YYYY-MM-DDTHH:MM:SS",
"error_code": 400,
"details": null,
"timestamp": "2024-07-17T12:00:00.123456"
}대상 날짜가 출생 이전 (400)
시간 순서 오류
{
"success": false,
"error": "Invalid value for 'body -> target_datetime': Target datetime must be after natal datetime",
"error_code": 400,
"details": null,
"timestamp": "2024-07-17T12:00:00.123456"
}잘못된 오브 범위 (400)
오브 범위 오류
{
"success": false,
"error": "Invalid value for 'body -> orb_degrees': ensure this value is less than or equal to 10.0",
"error_code": 400,
"details": null,
"timestamp": "2024-07-17T12:00:00.123456"
}사용량 제한 초과 (429)
Rate Limit 초과
{
"success": false,
"error": "Rate limit exceeded for feature: progressions",
"error_code": 429,
"details": null,
"timestamp": "2024-07-17T12:00:00.123456"
}에러 코드 요약
| 코드 | 설명 | 해결 방법 |
|---|---|---|
| 400 | 잘못된 요청 데이터 | 날짜 형식, 시간 순서, 좌표 범위, 오브 범위 확인 |
| 401 | 인증 실패 | 유효한 API 키를 X-API-Key 헤더에 포함 |
| 403 | 권한 없음 | 현재 플랜에서 progressions 기능 사용 가능 여부 확인 |
| 429 | 사용량 제한 초과 | 플랜 업그레이드 또는 다음 주기까지 대기 |
| 500 | 서버 내부 오류 | 잠시 후 재시도, 지속 시 고객 지원 문의 |
사용 예시
진행된 태양 별자리 변경 확인
30세가 되는 해에 진행된 태양이 쌍둥이자리에서 게자리로 이동했다면, 이는 의사소통과 정보 중심의 삶에서 감정과 가정 중심의 삶으로 근본적인 정체성 전환을 의미합니다.
진행된 달 주기 추적
진행된 달은 약 27-30개월마다 한 바퀴를 돌며, 각 별자리를 통과하는 약 2.5년은 그 별자리의 테마에 감정적으로 집중하는 시기입니다. 예를 들어 진행된 달이 전갈자리에 있으면 변화, 심리, 친밀감에 대한 욕구가 강해집니다.
진행 vs 트랜짓 비교
진행된 금성이 네이탈 태양과 합을 이룰 때(내적 변화) + 동시에 트랜짓 목성이 네이탈 금성과 트라인일 때(외부 기회) = 사랑과 관계에서 중요한 발전의 최적기
관련 엔드포인트
- Natal Chart API - 출생 차트 계산
- Transits API - 트랜짓 차트 계산
- Solar Returns API - 솔라 리턴 차트 계산
실전 활용 팁
진행 차트 분석 시 다음 순서로 접근하세요:
1. 진행된 태양 - 현재 인생 단계와 정체성 주제 파악
2. 진행된 달 - 현재 감정적 필요와 욕구 이해 (가장 빠르게 변화)
3. 진행된 개인 행성 (수성, 금성, 화성) - 사고, 관계, 행동 패턴의 진화
4. 진행-네이탈 애스펙트 - 내적 성장과 네이탈 잠재력의 통합
진행은 트랜짓과 함께 볼 때 가장 효과적입니다: 진행 = 내적 준비, 트랜짓 = 외부 계기.