# FitPulse

> Fitness intelligence API powered by evidence-based sports science. Custom workout plans, exercise form guides, macro targets, supplement analysis, injury recovery, rehab, sleep, plateau-breaking, and race training — via x402 micropayments on Base mainnet.

## Endpoints

GET /api/fit/workout?goal={goal}&equipment={equipment}&level={level}&days={n}
- Returns: full weekly workout schedule with exercises, sets, reps, rest periods, progression plan, and gear list with Amazon links
- goal examples: muscle-gain, fat-loss, strength, endurance, general-fitness
- equipment examples: full gym, dumbbells-only, bodyweight, barbell, resistance-bands
- level: beginner | intermediate | advanced (default: beginner)
- Optional: days (2-6, default 4), lang
- Price: $0.10

GET /api/fit/exercise?exercise={exercise}
- Returns: muscles worked (primary/secondary), difficulty, setup steps, execution cues, common mistakes with fixes, variations, programming recommendations for each level, gear with Amazon links
- exercise examples: barbell-squat, push-up, romanian-deadlift, pull-up, bench-press
- Optional: lang
- Price: $0.08

GET /api/fit/nutrition?goal={goal}&weight={lbs}&activity={level}
- Returns: daily calorie and macro targets (protein/carbs/fat), meal timing strategy, pre/post-workout nutrition, high-priority foods, sample day, hydration guidance
- activity: sedentary | lightly-active | moderately-active | very-active | athlete (default: moderately-active)
- Optional: weight (lbs), lang
- Price: $0.10

GET /api/fit/supplement?goal={goal}
- Returns: Tier 1 (strong evidence) and Tier 2 (moderate evidence) supplements with dose, timing, and Amazon links; skip list with reasons; safety notes
- goal examples: muscle-gain, fat-loss, endurance, recovery, general-health
- Optional: lang
- Price: $0.08

GET /api/fit/recover?injury={injury}
- Returns: see-doctor-immediately flags, recovery timeline, 3-phase protocol (acute/subacute/strengthening), return-to-sport criteria, prevention tips
- injury examples: sprained-ankle, pulled-hamstring, rotator-cuff, shin-splints, runners-knee, tennis-elbow
- Optional: lang
- Price: $0.10

GET /api/fit/supplements?goal={goal}&budget={budget}&restrictions={restrictions}
- Returns: evidence-graded (A/B/C/D) supplement efficacy tier list — 30+ supplements with dosing, timing, monthly cost estimates, and a skip/avoid list
- goal examples: muscle-gain, fat-loss, endurance, recovery, general-health
- Optional: budget (e.g. $50, $100, $200), restrictions (vegan, lactose-free, etc.), lang
- Price: $0.08

GET /api/fit/rehab?injury={injury}&sport={sport}&fitness_level={level}
- Returns: severity estimate, phased return-to-sport protocol (PEACE & LOVE framework), safe cross-training alternatives, return-to-sport criteria, red flags requiring a physician
- injury examples: ACL tear, rotator cuff strain, Achilles tendinopathy, hamstring strain
- Optional: sport, fitness_level (recreational, competitive, elite), lang
- Price: $0.10

GET /api/fit/sleep?issue={issue}&training_schedule={schedule}
- Returns: sleep architecture guidance, HRV-based training-readiness notes, evidence-graded supplement protocol, environment and nutrition-timing rules, CBT-I techniques
- issue examples: trouble falling asleep, early waking, poor recovery despite sleep, jet-lag
- Optional: training_schedule (e.g. morning workouts, two-a-days), lang
- Price: $0.08

GET /api/fit/plateau?goal={goal}&weeks_stuck={n}&current_routine={routine}
- Returns: plateau diagnosis, deload protocol, periodization model recommendation, rep-scheme changes, weak-link accessory work, nutrition checklist
- goal examples: squat strength, muscle size, bench press, endurance
- Optional: weeks_stuck (number), current_routine (e.g. 5x5 squat, 3x10 bench), lang
- Price: $0.10

GET /api/fit/race?race_type={type}&race_date={YYYY-MM-DD}&current_fitness={level}&runs_per_week={n}
- Returns: periodized training plan built backwards from race date — weekly structure, training phases, taper plan, race-day pacing strategy, gear checklist
- race_type examples: 5K, 10K, half-marathon, marathon, triathlon-sprint, triathlon-olympic, ironman, OCR
- Optional: current_fitness (beginner|intermediate|advanced), runs_per_week, lang
- Price: $0.10

## Payment

All endpoints use x402 protocol. No payment header → HTTP 402 with PAYMENT-REQUIRED header (0.08–0.10 USDC on Base mainnet). Send valid PAYMENT-SIGNATURE → 200 with structured JSON.

## Data Sources

- Tavily — real-time sports science research, exercise databases, rehabilitation guidelines
- Claude — synthesis and evidence-based analysis

## Affiliate Disclosure

Workout, exercise, and supplement responses include Amazon affiliate links (tag: pulsenetwork7-20) and other affiliate gear/training links for recommended equipment and supplements.

## Disclaimer

For informational purposes only. Not medical advice. Consult a healthcare provider before starting a new exercise program or supplement regimen, especially if you have medical conditions or injuries.