# PropPulse

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

Every endpoint accepts a free-form `location` (city, region, or postal code) plus optional `country` (e.g. US, UK, CA, DE, AU, IN). `zip` still works as a legacy alias for `location` and implies country=US when no country is given. Jurisdiction-aware for US/UK/CA/AU/DE/IN — mortgage structure, first-time-buyer schemes, and landlord tax treatment all adapt; other countries get honest generic handling rather than an invented US-style answer. Unspecified country is never silently treated as the US — responses state the assumption.

## Endpoints

GET /api/prop/mortgage?income=120000&down=60000&location=Austin+TX&country=US&debt=500
  Returns: jurisdiction-appropriate rate snapshot, monthly payment breakdown, max affordable price, mortgage-insurance flag if applicable, lender options, rate lock advice.
  Price: $0.10 USDC

GET /api/prop/afford?income=120000&down=40000&location=Manchester&country=UK&debt=500
  Returns: lender-qualifying ceiling vs. stress-free ceiling using the jurisdiction's own affordability convention (US DTI, UK income multiple, CA GDS/TDS, etc.), true monthly cost, 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&country=CA
  Returns: Opportunity assessment (strong/moderate/weak/not_recommended), rate-and-term + cash-out options where applicable, early-repayment-charge/prepayment-penalty awareness outside the US, break-even months, total interest savings.
  Price: $0.08 USDC

GET /api/prop/market?location=Bengaluru&country=IN
  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. National context is US-only (FRED) and labeled as such elsewhere.
  Price: $0.10 USDC

GET /api/prop/invest?location=Phoenix+AZ&price=350000&rent=2200
  Returns: cap rate, cash-on-cash return, gross rent multiplier, break-even occupancy, 5-year appreciation, investment grade, jurisdiction-aware landlord tax flags.
  Price: $0.15 USDC

GET /api/prop/valuate?address=123+Main+St+Austin+TX
  Returns: AVM-style value range with confidence, comparable sales, price-per-sqft, market trend, negotiation insight.
  Price: $0.10 USDC

GET /api/prop/neighborhood?location=Boerum+Hill+Brooklyn+NY
  Returns: overall score, school/safety/walkability/amenity context, demographics, investment outlook.
  Price: $0.10 USDC

GET /api/prop/first-buyer?location=Denver+CO&income=85000
  Returns: readiness assessment, real jurisdiction-specific down-payment/first-time-buyer schemes (US DPA/FHA/VA/USDA, UK Stamp Duty relief/LISA, CA FHSA/RRSP HBP, AU FHOG/FHSSS, honest no-scheme note for DE), closing costs, process timeline.
  Price: $0.10 USDC

GET /api/prop/landlord?location=Chicago+IL&units=4
  Returns: rent pricing, tenant screening, lease essentials, local landlord law, tax deduction flags, tool recommendations.
  Price: $0.12 USDC

GET /api/prop/rental-market?location=Manchester&country=UK&purchase_price=250000
  Returns: asking-rent level/trend, vacancy tightness, seasonality, deterministic rent-control flag, optional short-term-rental read + regulation flag (angle=str/investor/overview), optional budget/hostel rates (angle=budget/overview), deterministic gross-yield math when purchase_price is given. Distinct from HomePulse's single-address /api/home/rent, this API's own /api/prop/rentbuy (personal decision model), and FindPulse's equipment /api/find/rental.
  Price: $0.12 USDC

## Parameters

All endpoints support ?lang= for any language (Claude responds natively) and ?country= for jurisdiction-aware output.

## 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 — US only, clearly labeled as not applicable for other countries
- Tavily: hyperlocal market conditions, current lender comparisons, refi/remortgage market context, property tax rates, rental/short-term-rental/hostel rates by location and country

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