# Focus & Sleep Planner

Sleep-cycle bedtimes, caffeine decay, Pomodoro and nap schedules, sleep tally, jet-lag shifts and time blocks.

## 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://focus-sleep-calc.x402tookit.com/openapi.json
- x402 manifest: https://focus-sleep-calc.x402tookit.com/.well-known/x402
- Catalog (free): https://focus-sleep-calc.x402tookit.com/catalog
- Health (free): https://focus-sleep-calc.x402tookit.com/health
- Uptime (free): https://focus-sleep-calc.x402tookit.com/uptime

## Endpoints (7)

### GET /caffeine-decay — $0.02
Caffeine remaining after hours, and the time until it drops below a threshold, from a half-life you can set (default 5 hours).
Params: doseMg: number, halfLifeHours?: number, hoursElapsed?: number, thresholdMg?: number, doseTime?: string, bedtime?: string
Example: https://focus-sleep-calc.x402tookit.com/caffeine-decay?doseMg=200&halfLifeHours=5&hoursElapsed=10&thresholdMg=25&doseTime=2%3A00+PM&bedtime=10%3A00+PM

### GET /jet-lag-shift — $0.02
Day-by-day bedtime and wake-time shift toward a new time zone, with dates and 12-hour clock times. Planning only.
Params: direction: string, hoursDifference: number, startDate: string, bedtime: string, wakeTime: string, shiftPerDayHours?: number
Example: https://focus-sleep-calc.x402tookit.com/jet-lag-shift?direction=east&hoursDifference=6&startDate=2026-11-01&bedtime=11%3A00+PM&wakeTime=7%3A00+AM&shiftPerDayHours=1

### GET /nap-planner — $0.02
Nap lengths (10, 20, 30, 60, 90 minutes or your own) with the wake-up clock time for each, and a bedtime gap check.
Params: startTime: string, fallAsleepMinutes?: number, customMinutes?: number, bedtime?: string, minGapHours?: number
Example: https://focus-sleep-calc.x402tookit.com/nap-planner?startTime=1%3A30+PM&bedtime=10%3A30+PM

### GET /pomodoro-plan — $0.02
Pomodoro schedule for a task total in minutes: work blocks, short breaks, a long break every N blocks, with 12-hour clock times.
Params: totalMinutes: number, startTime: string, workMinutes?: number, shortBreakMinutes?: number, longBreakMinutes?: number, longBreakAfter?: number
Example: https://focus-sleep-calc.x402tookit.com/pomodoro-plan?totalMinutes=120&startTime=9%3A00+AM

### GET /sleep-cycles — $0.02
Bedtimes for a wake-up time, or wake times for a bedtime, using 90 minute cycles plus a fall-asleep allowance. Planning only.
Params: know: string, time: string, cycleMinutes?: number, fallAsleepMinutes?: number, minCycles?: number, maxCycles?: number
Example: https://focus-sleep-calc.x402tookit.com/sleep-cycles?know=wake&time=7%3A00+AM

### GET /sleep-debt — $0.02
Tally nightly sleep hours against a nightly need: net shortfall, short nights, average, and extra hours a night to even out.
Params: nights: string, needHours?: number, recoverNights?: number
Example: https://focus-sleep-calc.x402tookit.com/sleep-debt?nights=9%2C6%2C5%2C8%2C4&needHours=8&recoverNights=7

### GET /time-blocks — $0.02
Split a time window into equal blocks with breaks between them, with 12-hour clock times and the minutes left over.
Params: windowStart: string, windowEnd: string, blockMinutes: number, breakMinutes?: number
Example: https://focus-sleep-calc.x402tookit.com/time-blocks?windowStart=9%3A00+AM&windowEnd=12%3A00+PM&blockMinutes=50&breakMinutes=10

## Terms

Planning arithmetic only, never medical advice. Sleep cycles of 90 minutes, a 15 minute fall-asleep allowance and a 5 hour caffeine half-life are rules of thumb that vary a lot between people; they are inputs you can change. Not for diagnosing, treating or managing any sleep disorder, caffeine sensitivity, shift-work or health condition. Ask a clinician about those. Provided as is.