# Life Dates & Milestones

Exact age, next birthday, 1,000-day milestones, weekday of any date, zodiac signs, birthstones and generations.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://life-dates.x402tookit.com/openapi.json
- x402 manifest: https://life-dates.x402tookit.com/.well-known/x402
- Catalog (free): https://life-dates.x402tookit.com/catalog
- Health (free): https://life-dates.x402tookit.com/health
- Uptime (free): https://life-dates.x402tookit.com/uptime

## Endpoints (8)

### GET /age-detail — $0.02
Exact age from a birth date: years, months, days, total days, weeks and hours, birth weekday and days to the next birthday.
Params: birthDate: string, asOf?: string
Example: https://life-dates.x402tookit.com/age-detail?birthDate=1990-05-17&asOf=2026-10-11

### GET /birthstone-flower — $0.02
Traditional birthstone, alternates and birth flowers for a month number or birth date, plus a wedding-anniversary gift table.
Params: month?: integer, birthDate?: string, anniversaryYear?: integer
Example: https://life-dates.x402tookit.com/birthstone-flower?month=5

### GET /date-countdown — $0.02
Days between two dates (signed), as weeks plus days and years/months/days, with Monday-to-Friday days counted.
Params: to: string, from?: string
Example: https://life-dates.x402tookit.com/date-countdown?from=2026-10-12&to=2026-12-25

### GET /generation — $0.02
Generation label (Silent, Boomer, Gen X, Millennial, Gen Z, Alpha) for a birth year using Pew Research cut-offs.
Params: birthYear?: integer, birthDate?: string
Example: https://life-dates.x402tookit.com/generation?birthYear=1990

### GET /milestone-dates — $0.02
Dates of round-number days alive (1,000, 5,000, 10,000, 25,000 and your own), with weekday and age on that day.
Params: birthDate: string, days?: string, from?: string
Example: https://life-dates.x402tookit.com/milestone-dates?birthDate=1990-05-17&from=2026-10-11

### GET /next-birthday — $0.02
Next birthday on or after a date: its date, weekday, days to go and the age being turned, with the leap-day rule.
Params: birthDate: string, from?: string
Example: https://life-dates.x402tookit.com/next-birthday?birthDate=1990-05-17&from=2026-10-11

### GET /weekday-of-date — $0.02
Day of the week for any date from year 1000, with day of year, days left in the year, quarter and leap-year facts.
Params: date: string
Example: https://life-dates.x402tookit.com/weekday-of-date?date=2000-01-01

### GET /zodiac — $0.02
Western zodiac sign and Chinese zodiac animal with element for a birth date, flagging cusp days and lunar-year boundaries.
Params: birthDate: string
Example: https://life-dates.x402tookit.com/zodiac?birthDate=2000-05-17

## Terms

Date arithmetic computed locally in UTC calendar days from the dates given, provided as is. Zodiac, birthstone and flower lists are cultural conventions that differ by source, and the Chinese zodiac animal follows the lunar new year (late January to mid February), which this shelf does not look up. Generation labels follow Pew Research cut-offs and are sociological shorthand, not facts about a person. Not for legal age verification.