# SeniorPulse

AI-synthesized senior care intelligence API. All endpoints require x402 micropayment (USDC on Base mainnet) via PAYMENT-SIGNATURE header. Returns structured JSON.

## Endpoints

GET /api/senior/medicare?zip=78701&situation=turning+65
  Returns: Original Medicare vs. Advantage comparison, Medigap analysis, Part D guidance, enrollment deadlines, SHIP counseling referral.
  Price: $0.15 USDC

GET /api/senior/facility?type=assisted-living&location=Austin+TX&budget=5000
  Returns: Facility type comparison, cost ranges, evaluation checklist, red flags, questions to ask, A Place for Mom link, CMS Care Compare link.
  Valid types: assisted-living, memory-care, skilled-nursing, independent-living, home-care
  Price: $0.15 USDC

GET /api/senior/meds?medications=metformin,lisinopril,aspirin,diphenhydramine&age=74
  Returns: Beers Criteria flags, drug interaction warnings, geriatric dosing concerns, black box warnings, questions for pharmacist. Uses FDA drug label API.
  Price: $0.10 USDC

GET /api/senior/benefits?state=Texas&income=1200&assets=15000&veteran=false
  Returns: Likely eligible programs (SSI, Medicaid, Medicare Savings, VA, PACE), income/asset thresholds, how to apply, BenefitsCheckUp.org referral.
  Price: $0.10 USDC

GET /api/senior/caregiver?situation=caring+for+85yo+mother+with+dementia&location=Austin+TX
  Returns: Legal document checklist (POA, healthcare proxy, advance directive), respite options, local resources, burnout prevention, Amazon product links.
  Price: $0.10 USDC

## Parameters

All endpoints support ?lang= for any language (Claude responds natively).

## Payment

Send GET without PAYMENT-SIGNATURE to receive 402 + payment requirements.
Sign payment and retry with PAYMENT-SIGNATURE header.
Payment settles on Base mainnet (USDC).
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Data Sources

- FDA Drug Label API (free, no key): drug interactions, geriatric use warnings, black box warnings, Beers Criteria context
- Tavily: Medicare plan context, local facility ratings, benefits eligibility by state, caregiver resources

## Discovery

- OpenAPI: /openapi.json
- Agent discovery: /.well-known/agent.json

## Important

All endpoints include strong disclaimers. SeniorPulse provides information only — not medical, legal, or financial advice. /api/senior/meds is especially safety-critical and always recommends pharmacist/physician consultation.

## Network

Part of PulseNetwork — 15+ specialized intelligence APIs.