---
title: "Career Annual (year-by-year 流年)"
method: GET
path: "/api/trpc/user.careerAnnual"
tags: ["Product"]
---

# Career Annual (year-by-year 流年)

`GET /api/trpc/user.careerAnnual`

## Request

- Base URL: `https://api.asktian.com`
- URL: `https://api.asktian.com/api/trpc/user.careerAnnual`
- Auth: HTTP bearer

The per-YEAR (流年) layer below careerArc's decades (taxonomy annual-1): a window of years (fromYear or fromAge + horizonYears, 1–90, default 30) where each year carries { year, age, decadeIndex, annualPillar (干支), animal, tenGod (the year's 十神), phase (initiate/build/consolidate/pivot), theme (forecast-1 enum), career & wealth on the SAME 0–100 scale as careerArc's decades, status, optional danger flag (clash/太歲/反吟/伏吟/冲提纲/岁运并临) and turning flag (三合/三会 应期 / 岁运并临), and one symbolic note }. Consistent with careerArc by construction: each year is its decade's exact score modulated by its own 十神 (a year matching its decade scores exactly the decade), and the danger/turning flags are byte-identical to careerArc's. Pure function of birth; asOf tags each year past/current/future only — buy once and cache. Deterministic, no LLM. OMITTED GENDER DISCLOSED (genderAssumption): the decade direction underneath the timing layer is the male assumption when gender is omitted — a female chart's decades run the other way; the marker is absent when gender was supplied. Seeker-facing self-insight — per the API terms never employer screening input.

Cost: 15 TIAN Points per call. tRPC procedure `user.careerAnnual`.

## 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)