# PetPulse

> Veterinary intelligence API — evidence-based pet health guidance via x402 micropayments on Base mainnet.

PetPulse provides AI-synthesized veterinary intelligence grounded in PubMed peer-reviewed research and FDA animal drug adverse event data. All endpoints return structured JSON and require x402 USDC micropayment on Base mainnet.

## Endpoints

GET /api/pet/symptoms?species={dog|cat|...}&symptoms={comma-separated}
- Returns: urgency rating (emergency / urgent / monitor / routine), urgency explanation, go-now signs, possible causes with likelihood, home care, what to tell your vet
- Optional: age, weight, lang
- Price: $0.10

GET /api/pet/research?topic={topic}&species={dog|cat|...}
- Returns: PubMed-grounded research synthesis, evidence quality rating, key findings, clinical implications, product recommendations with Amazon + Chewy links
- Optional: lang
- Price: $0.10

GET /api/pet/nutrition?condition={condition}&species={dog|cat|...}
- Returns: dietary approach, foods to emphasize, foods to avoid, key nutrients, supplements with evidence ratings, feeding tips, prescription diet options
- Optional: lang
- Price: $0.10

GET /api/pet/medication?drug={name}&species={dog|cat|...}
- Returns: drug class, approved uses, typical dosing, mechanism of action, side effects (common/serious), contraindications, drug interactions, FDA adverse event data
- Optional: weight, condition, lang
- Price: $0.08

GET /api/pet/breed?breed={breed-name}&topic={health|nutrition|exercise|grooming}
- Returns: breed overview, health risks with prevalence, nutrition notes, exercise needs, recommended products with Amazon + Chewy links, vet screenings to request
- Optional: lang
- Price: $0.08

## 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

- PubMed E-utilities (NIH) — peer-reviewed veterinary research, no API key required
- FDA openFDA Animal & Veterinary API — adverse event reports, no API key required
- Tavily — real-time veterinary context and breed information
- Claude Sonnet — synthesis and clinical interpretation

## Affiliate Disclosure

Responses include Amazon and Chewy purchase links for recommended products. Links are affiliate links that support the service at no additional cost.

## Disclaimer

For informational purposes only. Not veterinary advice. Always consult a licensed veterinarian for diagnosis, treatment, and medical decisions.