Raw schema
{
"type": "object",
"properties": {
"birthYear": {
"description": "Birth year Gregorian year, e.g. 1980.",
"type": "number",
"minimum": 1940,
"maximum": 2010,
"default": 1980
},
"birthMonth": {
"description": "Birth month The reform buckets by birth month, so this changes the answer.",
"type": "number",
"minimum": 1,
"maximum": 12,
"default": 1
},
"track": {
"description": "Which track are you on? The decisive input. For women it hinges on your file classification (管理/技术岗 vs 工人岗), not job title — and it is the single most disputed point, so choose carefully.",
"type": "string",
"enum": [
"male",
"female-cadre",
"female-worker"
],
"default": "male"
},
"mode": {
"description": "Pension figures are… Choose “project” if you are still years from retiring: the account keeps growing at the 记账利率 and contributions keep landing, so today’s balance is not the retirement balance.",
"type": "string",
"enum": [
"at-retirement",
"project"
],
"default": "at-retirement"
},
"city": {
"description": "City / province Sets your province’s pension calculation base (养老金计发基数) — the number you would otherwise have to look up. Pick “Other” to enter your own below.",
"type": "string",
"enum": [
"beijing",
"shanghai",
"tianjin",
"guangzhou",
"shenzhen",
"dongguan",
"foshan",
"zhuhai",
"nanjing",
"suzhou",
"wuxi",
"changzhou",
"nantong",
"hangzhou",
"ningbo",
"wenzhou",
"fuzhou",
"xiamen",
"jinan",
"qingdao",
"chengdu",
"chongqing",
"wuhan",
"changsha",
"zhengzhou",
"nanchang",
"xian",
"hefei",
"kunming",
"guiyang",
"nanning",
"taiyuan",
"shijiazhuang",
"shenyang",
"dalian",
"harbin",
"other"
],
"default": "beijing"
},
"avgWage": {
"description": "Pension base override 社平工资 (optional) Leave 0 to use your city’s published base above. Enter a number only to override it (or for a city not listed). In “project” mode this is today’s base; it is grown to retirement.",
"type": "number",
"minimum": 0,
"default": 0
},
"contributionIndex": {
"description": "Average contribution index 平均缴费指数 Your contribution base ÷ local average wage, averaged over your career. Capped 0.6–3.0. 1.0 = you always paid on exactly the average wage.",
"type": "number",
"minimum": 0.6,
"maximum": 3,
"default": 1
},
"contributionYears": {
"description": "Contribution years 缴费年限 Total years contributed, including deemed years 视同缴费年限. In “project” mode this is years so far; the years until retirement are added.",
"type": "number",
"minimum": 0,
"maximum": 50,
"default": 35
},
"accountBalance": {
"description": "Individual account balance 个人账户储存额 The accumulated balance in your personal pension account. In “project” mode this is today’s balance; it is grown to retirement.",
"type": "number",
"minimum": 0,
"default": 300000
},
"asOfYear": {
"description": "Today’s figures are from (year) Only used in “project” mode — the year your current balance/base are from. Years-to-retirement is counted from here.",
"type": "number",
"minimum": 2025,
"maximum": 2060,
"default": 2026
},
"bookingRate": {
"description": "Account crediting rate 记账利率 (%) Project mode only. The government-published annual rate credited to your individual account (记账利率) — recent years ~6%. This is not a market investment return.",
"type": "number",
"minimum": 0,
"maximum": 12,
"default": 6
},
"growthRate": {
"description": "Annual salary / base growth (%) Project mode only. Assumed yearly growth of your salary and the local wage base — both future contributions and the indexed basic pension rise with it.",
"type": "number",
"minimum": 0,
"maximum": 15,
"default": 3
}
},
"required": [],
"additionalProperties": false
}