Developer portal

Your access

—

First call

Confirm your credentials work before debugging any payload.

curl https://kpstellarastro.com/api/v1/ping \
  -H "X-App-Id: YOUR_APP_ID" \
  -H "X-App-Secret: YOUR_APP_SECRET"

1. Run the command above with your own values.
2. A 200 with "ok": true means the keys are good.
3. Then move on to POST /api/v1/birth-chart for a real reading.

Python SDK Free

Official client — auth headers, typed errors, one method per endpoint. Free and open; only the API calls themselves are metered against your subscription above.

pip install kpstellar

from kpstellar import Client
client = Client(app_id="YOUR_APP_ID", app_secret="YOUR_APP_SECRET")
client.ping()

Not yet on PyPI — download the zip above and install locally with pip install ..

JavaScript / TypeScript SDK Free

Official client for Node 18+ — same shape as the Python one: typed errors, one method per endpoint. Free and open; only the API calls themselves are metered against your subscription above.

import { Client } from "kpstellar";
const client = new Client({ appId: "YOUR_APP_ID", appSecret: "YOUR_APP_SECRET" });
await client.ping();

Not yet on npm — the downloaded zip includes a pre-built dist/, so it works without a build step; run npm install only if you want to rebuild from src/.