# 탄생 차트 API

natal chart( natal chart)는 모든 astrology 앱(Co-Star, Sanctuary, The Pattern, Chani)의 핵심Foundation이다. AstroWay API는 단일 호출로 natal chart를 생성하고 분석할 수 있는 포괄적인 엔드포인트 집합을 제공한다. Swiss Ephemeris( Solar Fire 및 Astrodienst에서 사용하는 것과 동일)를 기반으로 하며, 경쟁사에서 제공하지 않는 희귀한 기술까지 700개 이상의 엔드포인트로 구성된 플랫폼의 모든 기능을 제공한다.

## 계산되는 항목

완전한 natal chart는 **astrology trinity**—사용자들이 계속해서 되돌아보며 retention을 높이는 세 가지 '면모'—를 포함한다:

- **행성 위치** — Sun(정체성/목적), Moon(정서적 핵심/욕구), Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto + North Node, Chiron. 경도, 위도, 속도, 별자리, 하우스, 역행 여부.
- **하우스 쿠스피드** — 15개 시스템 선택 가능(Placidus, Koch, Whole Sign, Equal 등). ASC(타인이 보는 사용자 이미지), MC(직업/공적 이미지), Vertex.
- **아スペクト(aspects)** — conjunction, opposition, trine, square, sextile, quincunx. 오브 orb, applying/separating.
- **세타 карта(Chart Sect)** —昼間/夜間(고전 헬레니즘 astrology 스타일 Chris Brennan / Demetra George).

## 엔드포인트

| 엔드포인트 | 크레딧 | 반환 값 |
|---|---|---|
| `/v1/chart` | 20 | 완전한 natal chart(행성 + 하우스 + aspects) |
| `/v1/planets` | 10 | 행성 위치만(하우스와 aspects 제외) |
| `/v1/essential-dignities` | 20 | 본질적 dignity(거주지, exaltation, triplicity, term, face) 테이블 |
| `/v1/almuten` | 20 | Альмутен figuris — 중세 astrology 기술 |
| `/v1/arabic-parts` | 20 | 아랍어 parts/жереби(Fortuna, Spirit 등) |
| `/v1/fixed-stars` | 20 | 행성과 고정 별의 conjunction |
| `/v1/midpoints` | 20 | planetary midpoints |
| `/v1/disposition-chains` | 20 | disposition chains(제어 그래프) |
| `/v1/firdaria` | 20 | Firadaria 기간 |
| `/v1/profections` | 20 | 연간 profections |
| `/v1/planetary-phases` | 20 | Oriental/occidental phases |
| `/v1/receptions` | 20 | 상호 reception |

## 예시

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/chart \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "date": "1990-07-14",
        "time": "14:30:00",
        "timezoneOffset": 3,
        "latitude": 50.4501,
        "longitude": 30.5234,
        "houseSystem": "P"
      }'
    ```
  </TabItem>
  <TabItem label="Node.js">
    ```ts
    const r = await fetch('https://api.astroway.info/v1/chart', {
      method: 'POST',
      headers: {
        'X-Api-Key': process.env.ASTROWAY_API_KEY!,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        date: '1990-07-14',
        time: '14:30:00',
        timezoneOffset: 3,
        latitude: 50.4501,
        longitude: 30.5234,
        houseSystem: 'P',
      }),
    });
    const { data: chart } = await r.json();
    console.log(`ASC: ${chart.angles.asc.sign} ${chart.angles.asc.degree.toFixed(2)}°`);
    ```
  </TabItem>
  <TabItem label="Python">
    ```python

    r = requests.post(
        'https://api.astroway.info/v1/chart',
        headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
        json={
            'date': '1990-07-14',
            'time': '14:30:00',
            'timezoneOffset': 3,
            'latitude': 50.4501,
            'longitude': 30.5234,
            'houseSystem': 'P',
        },
    )
    chart = r.json()['data']
    print(f"ASC: {chart['angles']['asc']['sign']} {chart['angles']['asc']['degree']:.2f}°")
    ```
  </TabItem>
  <TabItem label="PHP">
    ```php
    <?php
    use GuzzleHttp\Client;

    $aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
    $r = $aw->post('chart', [
        'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
        'json' => [
            'date' => '1990-07-14',
            'time' => '14:30:00',
            'timezoneOffset' => 3,
            'latitude' => 50.4501,
            'longitude' => 30.5234,
            'houseSystem' => 'P',
        ],
    ]);
    $chart = json_decode($r->getBody(), true)['data'];
    printf("ASC: %s %.2f°\n", $chart['angles']['asc']['sign'], $chart['angles']['asc']['degree']);
    ```
  </TabItem>
</Tabs>

## 사용자

- **astrology 앱** — natal chart를 그리는 web 및 mobile 앱
- **AI 에이전트** — MCP 서버 또는 `/interpret/natal`을 통한 AI 해석
- **연구자** — 통계 연구를 위한 대량 계산
- **컨텐츠 플랫폼** — 기존 제품 위에 natal chart를 피처로 추가

## 가격

natal chart(`/v1/chart`)는 **20 크레딧**이다. Free 플랜(월 10,000 크레딧)에서 매달 500개의 natal chart를 무료로 사용할 수 있다.

<CardGrid>
  <LinkCard title="빠른 시작 →" href="/getting-started/" description="5분 만에 첫 요청 보내기" />
  <LinkCard title="자세한 예시" href="/examples/natal/" description="파라미터, 응답, 하우스 시스템" />
  <LinkCard title="요금제" href="/pricing/" description="무료부터 Enterprise까지" />
</CardGrid>