概要
AstroWay APIとは？
プロフェッショナルなHTTP APIで占星術計算を提供します。771 エンドポイントはSwiss Ephemerisをベースにしており、出生図、シナストリー、プログレッション、ディレクション、トランジット、Human Design、アストロカートグラフィー、レクティフィケーション、AI解釈をサポートします。すべての計算はサーバー側で行われ、クライアント側に依存はありません。
このAPIは誰向け？
Web/モバイルの占星術アプリを作る開発者、占星機能を追加するAI企業、スクリプトを持つプロの占星術師、そして計算へのプログラムアクセスが必要な研究者向けです。
計算の精度は？
Swiss Ephemerisは惑星位置を±1秒角、ハウスカスピッドを±1分角の精度で提供します。結果はAstrodienst（Astro.com）、Solar Fire、Zet 9、Keplerと比較検証済みです。NASA JPLエフェメリスやNASA 5-Millennium Eclipse Catalogに対してサブアーク秒レベルのドリフトがあります。
AstroWayはAstro.comやSolar Fireとどう比較される？
Swiss EphemerisエンジンはSolar Fire（ライセンス$495）、Kepler（$995）、Astro Gold（$29.99/月）、Astrodienst（Astro.com）と同一です。NASA JPLエフェメリスとAstrodienstの公式swetestリファレンスに対して検証済みです。惑星位置のドリフトは≤0.1″、食の時間は≤1分です。違いは、AstroWayは$5/月からのREST APIで、買い切りライセンスやデスクトップGUIではありません。
サポートされているハウスシステムは？
15種類のハウスシステムをサポート：Placidus（デフォルト）、Koch、Whole Sign、Equal、Regiomontanus、Campanus、Topocentric、Alcabitius、Morinus、Porphyrius、Vehlow、Krusinski-Pisa、Hindu Bhava、APC、そしてMCからのEqualです。対応するコードをパラメータ houseSystem に渡してください。
クレジットと支払い
クレジットシステムはどう機能する？
各エンドポイントは計算の複雑さに応じてクレジットで固定料金が設定されています（10〜500クレジット）。シンプルなlookupは10、出生図は20、シナストリーは50、レクティフィケーションは500です。全料金表は料金表ページをご覧ください。
無料プランはある？
はい。Freeプランは月間10,000クレジット、毎分10リクエストを提供します。カード情報は不要です。製品の評価やプロトタイピングに十分です。
クレジットがなくなったらどうなる？
Freeプランではクレジットが尽きると次の月までリクエストがブロックされます（429 CREDITS_EXHAUSTED）。Indie/Starter/Pro/Businessプランではオーバーエージが適用され、10,000追加クレジットごとにそれぞれ$5 / $3 / $2 が課金されます。
同じリクエストはキャッシュされる？
はい。同一の入力は5分間キャッシュされ、クレジットは消費されません。X-Cache: HIT ヘッダーで確認できます。
サブスクリプションなしでクレジットを購入できる？
現時点ではできません。サブスクリプションは予測可能な予算とより良いレートリミットを提供します。従量課金プランは計画中です。
技術情報
利用可能なSDKは？
- MCPサーバー ✅ 実装済み:
npx -y @astroway/mcp：すべての 771+ エンドポイントをClaude Desktop、Cursor、GPT、その他のMCP対応AIエージェント向けツールとして公開します - TypeScript SDK ✅ 実装済み:
npm install @astroway/sdk：OpenAPI 3.1 に基づく型定義とオートコンプリート、リトライと冪等性、Stainlessスタイルのエラーを提供 - Python SDK ✅ 実装済み:
pip install astroway：同期Astrowayと非同期AsyncAstrowayを提供、httpxベース、PEP 561 による型付け - PHP SDK ✅ 実装済み:
composer require astroway/sdk：PHP 8.1+、Guzzle 7 + PSR-18、リトライミドルウェアをサポート - Go / Ruby / Rust 📋 計画中: 各SDKページ（
/sdk/<language>/）でメール通知に登録してください
APIの契約は標準的なREST + JSONで、任意のHTTPクライアントがSDKなしで利用可能です。PostmanコレクションとOpenAPI 3.1仕様は公開されています。
サンドボックスモードはある？
はい。キー aw_test_* はクレジットを消費せず、同じ結果を返します。開発やテストに最適です。
レートリミットは？
プランにより異なります：Free - 10、Indie - 30、Starter - 120、Pro - 400、Business - 1,000 リクエスト/分。超過時は Retry-After ヘッダー付きで429が返ります。
サイデリアル黄道帯はサポートされている？
はい。"zodiacType": "sidereal" を渡し、オプションで "ayanamsaId"（デフォルトはLahiri）を指定してください。すべてのエンドポイントで動作します。
Human Designエンドポイントとは？
Human Designの計算用に12のエンドポイントがあります：タイプ、ストラテジー、オーソリティ、プロファイル、ディテクション、インカーネーションクロス、チャンネル、センター、Dream Rave、Hologenetic Profile、Penta（グループダイナミクス）、時間感受性。商用APIの中で最も包括的なHDカバレッジです。
セキュリティとプライバシー
リクエストデータは保存される？
APIはステートレスで、出生日時や座標のデータはリクエスト処理後に保存されません。ログに残るのはkey_id、エンドポイント、タイムスタンプ、レイテンシ、クレジットのみです。個人データは一切保存されません。
APIはGDPR要件に準拠している？
はい。データは保存されません。EUユーザー向けにPIIの処理、プロファイリング、クッキーは一切ありません。APIキーはアカウントに紐付けられ、エンドユーザーには結びつきません。
AI解釈は安全か？
AIエンドポイント（/interpret/*、/horoscope/*）には組み込みの安全ガードレールがあり、医療、法務、金融の助言は禁じられています。各レスポンスには免責事項が含まれます。完全な監査トレイルが提供され、エンタープライズコンプライアンスに対応します。
サポート
サポートを受けるには？
プランに応じて異なります：Free - コミュニティ、Indie - メール（48時間以内）、Starter - メール（24時間以内）、Pro - メール（4時間以内）、Business - メール＋Slack（1時間以内）、Enterprise - Slackの専任マネージャー。連絡先はお問い合わせページをご覧ください。
SLAはある？
Indie：99% の稼働率。Starter と Pro：99.9% の稼働率。Business：99.95% の稼働率。Enterprise：財務保証付きのカスタムSLAです。
類似名称
AstroWay API (astroway.info)はastroway.lifeの「Astroway」サブスクリプションと関係がある？
いいえ。astroway.info と api.astroway.info は別個の独立した会社です。 私たちは開発者向けに占星術API（api.astroway.info）、エンドユーザー向けアプリ（app.astroway.info）および占星術コンサルティングを提供しています。**「Astroway」という名称で宣伝・課金されている消費者向け占星術サブスクリプション（astroway.life 経由、no-reply@astroway.life からのメール、人物「Celeste」、銀行明細の「Astroway」）とは一切関係がありません。このサブスクリプションの運営者は TrafficLeader OÜ（エストニア、traffic-leader.com も使用）で、関連する請求業者 SKYREAD.PRO は ABCMobile OÜ（エストニア）です。名前が似ているだけで、別々の会社です。
「Astroway」に課金される – サブスクリプションをキャンセルして返金するには？
もし「Astroway」のサブスクリプションで課金されている場合（no-reply@astroway.life からのメール、銀行明細に「Astroway」）、それは 別会社の astroway.life であり、私たちではありません。私たちはそのサービスのアカウントや支払いにアクセスできないため、 キャンセルや返金はできません。対処方法は以下です：
no-reply@astroway.lifeへのメールに直接返信し、フッターにある「配信停止 / キャンセル」リンクを使用してください。- 返答がない場合は ご利用の銀行またはカード発行元（明細の「Astroway」支払い、マーチャントは TrafficLeader OÜ または ABCMobile OÜ / SKYREAD.PRO、エストニア）に連絡し、再課金のブロックまたは返金（チャージバック）を依頼してください。