# ClearCarePulse

Hospital price transparency intelligence API. All endpoints require x402 micropayment (USDC on Base mainnet).

## What it does

ClearCarePulse maps plain-English procedure descriptions to CPT codes, benchmarks against Medicare rates, and helps patients find the lowest-cost providers — before they commit to care. Covers medical procedures, dental, cosmetic, bill negotiation, and insurance OOP calculations.

## Endpoints

### GET /api/care/search — $0.15
Find lowest-cost providers for a procedure by zip code. Returns providers sorted low-to-high by cash price with Medicare benchmark.
Required: procedure, zip | Optional: radius (miles), lang

### GET /api/care/hospital — $0.10
Retrieve a specific hospital's published prices (chargemaster, negotiated rates, cash price) for a procedure. Includes payer breakdown and negotiation script.
Required: hospital, procedure | Optional: lang

### GET /api/care/episode — $0.15
Break down the total episode cost: surgeon fee, anesthesia, facility fee, PT, DME, follow-up. Calculate OOP liability with your insurance parameters.
Required: procedure | Optional: deductible, deductible_met, coinsurance, oop_max, lang

### GET /api/care/oop — $0.15
Out-of-pocket calculator. Give it your deductible, coinsurance, OOP max, and HSA status — get exact patient liability with HSA tax savings.
Required: procedure | Optional: procedure_cost, plan_type, deductible, deductible_met, coinsurance, oop_max, oop_spent, hsa, lang

### GET /api/care/alternatives — $0.10
Find lower-cost care settings: ASC vs hospital outpatient, freestanding imaging centers, urgent care, FQHC sliding scale, telemedicine.
Required: procedure | Optional: zip, current_setting, lang

### GET /api/care/negotiate — $0.10
Medical bill negotiation guide with exact scripts, Medicare benchmark targeting, charity care eligibility, and billing advocate referrals.
Required: procedure | Optional: bill_amount, hospital, insured, income, lang

### GET /api/care/dental — $0.10
Dental cost intelligence. Maps to CDT codes, provides FairHealth UCR benchmarks (50th/80th/90th percentile), compares discount plan vs. insurance pricing.
Required: procedure | Optional: zip, has_insurance, lang

### GET /api/care/cosmetic — $0.10
Cosmetic and elective procedure costs. ASPS surgeon fee benchmarks, total episode cost (surgeon + anesthesia + facility), geographic adjustment, financing options.
Required: procedure | Optional: location, lang

## Payment

Protocol: x402 | Network: Base mainnet (eip155:8453) | Asset: USDC
Contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
payTo: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Data Sources

- Hospital price transparency files (No Surprises Act / CMS 2021 mandate)
- CMS Medicare OPPS/MPFS rate schedules
- FairHealth consumer UCR benchmarks for dental
- ASPS (American Society of Plastic Surgeons) annual statistics
- Tavily real-time web search
- Claude synthesis for CPT/CDT code mapping and cost analysis

## Part of PulseNetwork

Related APIs: SeniorPulse (seniorpulse.vercel.app), InsurePulse (insurepulse.vercel.app), WealthPulse (wealthpulse-phi.vercel.app)

Disclaimer: For informational purposes only. Price estimates based on publicly available data. Not medical or financial advice.