# PropPulse

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

## Endpoints

GET /api/prop/mortgage?income=120000&down=60000&location=Austin+TX&debt=500
  Returns: 30/15yr/ARM rate snapshot, monthly payment breakdown (PITI), max affordable price, PMI if applicable, lender options, rate lock advice, LendingTree action link.
  Price: $0.10 USDC

GET /api/prop/afford?income=120000&down=40000&zip=78701&debt=500
  Returns: Bank-qualifying ceiling vs. stress-free ceiling, true monthly cost (including maintenance reserve), DTI analysis, honest assessment if numbers are tight.
  Price: $0.10 USDC

GET /api/prop/rentbuy?rent=2200&location=Austin+TX&savings=80000&years=5
  Returns: Buy vs. rent recommendation, break-even timeline in months, 5-year wealth comparison, key factors for each path, market context.
  Price: $0.10 USDC

GET /api/prop/refi?rate=7.25&balance=312000&years_left=24&home_value=520000
  Returns: Opportunity assessment (strong/moderate/weak/not_recommended), rate-and-term + cash-out options, break-even months, total interest savings.
  Price: $0.08 USDC

GET /api/prop/market?zip=78701
  Returns: Market rating (strong_seller to strong_buyer), market score 0-100, price trends, days on market, months supply, buyer and seller briefings, 3-month outlook.
  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

- FRED (Federal Reserve): mortgage rates (30yr, 15yr, ARM), median home price, housing starts, permits, months supply, median household income
- Tavily: hyperlocal market conditions, current lender comparisons, refi market context, property tax rates by location

## Discovery

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

## Network

Part of PulseNetwork — 14+ specialized intelligence APIs. Cross-sell suggestions included in responses when genuinely relevant.