---
title: "Eclipses (Grahan) (日月食)"
method: GET
path: "/api/trpc/eclipses.upcoming"
tags: ["Western"]
---

# Eclipses (Grahan) (日月食)

`GET /api/trpc/eclipses.upcoming`

## Request

- Base URL: `https://api.asktian.com`
- URL: `https://api.asktian.com/api/trpc/eclipses.upcoming`
- Auth: HTTP bearer

Sūrya & Chandra Grahan: eclipse search canon-locked to the minute (2026–27 record pinned in tests), lunar phase windows with nesting proven, true local solar contact times on request, and the sutak convention served with its edges stated — no sutak for penumbral, visibility honesty throughout.

Cost: 2 TIAN Points per call. tRPC procedure `eclipses.upcoming`.

## Query parameters

- `input` string

## Response `200`

tRPC result envelope

- TrpcResult: tRPC HTTP response envelope.
  - `result` object
    - `data` object: The procedure's return value (system-specific).

---

[API](https://skmtc.dev/asktian/apis/asktian-metaphysics-api.md) · [All operations](https://skmtc.dev/asktian/apis/asktian-metaphysics-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asktian/apis/asktian-metaphysics-api/revisions/3c8fdc979206?raw)