# FitPulse

> Fitness intelligence API powered by evidence-based sports science. Custom workout plans, exercise form guides, macro targets, supplement analysis, and injury recovery protocols — 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

## 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 Sonnet — synthesis and evidence-based analysis

## Affiliate Disclosure

Workout, exercise, and supplement responses include Amazon affiliate links (tag: pulsenetwork7-20) for recommended gear 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.