Stream Void-of-Course

POST

/stream/void-of-course

request.sh

curl -X POST https://api.astroway.info/v1/stream/void-of-course \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{}'

▸ Спробувати POST /stream/void-of-course

• Production

Current Moon VOC + next ingress.

Authorizations

• ApiKeyAuth

Request Body ^required

Media type application/json

This endpoint reads nothing from the request body. Send {} (or any object, which is ignored).

object

Example

{}

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

timestamp

string

nullable

julianDay

number

nullable

status

object

isVoC

boolean

nullable

currentPeriod

nullable

nextIngress

object

jd

number

nullable

at

string

nullable

sign

string

nullable

longitude

number

nullable

nextEventAt

string

nullable

tickSeconds

number

nullable

transport

string

nullable

sseUpgrade

string

nullable

pricing

string

nullable

Example

{
  "ok": true,
  "data": {
    "timestamp": "2026-08-23T22:05:27.274Z",
    "julianDay": 2461276.4204513887,
    "status": {
      "isVoC": false,
      "currentPeriod": null
    },
    "nextIngress": {
      "jd": 2461277.876115446,
      "at": "2026-08-25T09:01:36.374Z",
      "sign": "Aquarius",
      "longitude": 299.9992972156107
    },
    "nextEventAt": "2026-08-25T09:01:36.374Z",
    "tickSeconds": 600,
    "transport": "http-polling",
    "sseUpgrade": "Use the same endpoint with /sse subpath for Server-Sent Events (planned).",
    "pricing": "10 credits/call (Tier 1): each tick recomputes positions, so it is a live compute, not a cheap lookup. Poll on the returned `tickSeconds`; see docs/PRICING.md §11."
  }
}

400

Validation error

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Validation failed: date: Date must be YYYY-MM-DD",
    "details": [
      {
        "path": "date",
        "message": "Date must be YYYY-MM-DD"
      }
    ]
  }
}

401

Missing or invalid API key

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}