{
  "name": "PropPulse",
  "description": "AI-synthesized real estate intelligence API covering any country. Mortgage/remortgage analysis, true affordability modeling, rent vs. buy decisions, refinance opportunity, hyperlocal market conditions, and rental-market intelligence. Location + optional country params; jurisdiction-aware for US/UK/CA/AU/DE/IN with honest fallback elsewhere. Returns structured JSON. Requires x402 micropayment (USDC on Base mainnet).",
  "version": "1.1.0",
  "url": "https://proppulse.theaslangroupllc.com",
  "payment": {
    "protocol": "x402",
    "network": "eip155:8453",
    "asset": "USDC",
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc",
    "price_range_usd": "0.08–0.15"
  },
  "capabilities": [
    "Jurisdiction-aware mortgage/remortgage analysis with payment breakdown (US PITI/PMI, UK fixed-deal/remortgage, CA term/amortization, DE Zinsbindung, AU offset, IN floating)",
    "True affordability ceiling using each jurisdiction's own convention (US DTI, UK income multiple, CA GDS/TDS, AU serviceability buffer, IN EMI ratio)",
    "Rent vs. buy decision modeling with break-even timeline and 5-year wealth comparison, any currency",
    "Refinance/remortgage opportunity analysis, including early-repayment-charge/prepayment-penalty awareness outside the US",
    "Hyperlocal market intelligence — buyer/seller rating, price trends, days on market, inventory, any country",
    "Rental-market intelligence — asking rent, vacancy, rent-control flag, short-term-rental read + regulation flag, budget/hostel rates, deterministic gross-yield math"
  ],
  "data_sources": [
    "FRED (Federal Reserve): 30yr/15yr/ARM mortgage rates, median home price, housing starts, building permits, months supply — US only, clearly labeled as not applicable elsewhere",
    "Tavily: hyperlocal market conditions, current lender comparisons, property tax rates, rental/short-term-rental/hostel rates by location and country"
  ],
  "endpoints": [
    {
      "path": "/api/prop/mortgage",
      "method": "GET",
      "description": "Jurisdiction-aware mortgage rates, monthly payment breakdown, max affordable price, lender options",
      "required_params": ["income"],
      "optional_params": ["down", "location", "country", "zip", "debt", "lang"],
      "price_usd": 0.10
    },
    {
      "path": "/api/prop/afford",
      "method": "GET",
      "description": "True affordability — lender-qualifying vs. stress-free ceiling, jurisdiction's own affordability convention",
      "required_params": ["income"],
      "optional_params": ["down", "location", "country", "zip", "debt", "lang"],
      "price_usd": 0.10
    },
    {
      "path": "/api/prop/rentbuy",
      "method": "GET",
      "description": "Rent vs. buy recommendation, break-even timeline, 5-year comparison",
      "required_params": ["rent"],
      "optional_params": ["location", "country", "savings", "years", "lang"],
      "price_usd": 0.10
    },
    {
      "path": "/api/prop/refi",
      "method": "GET",
      "description": "Refinance/remortgage analysis — break-even, monthly savings, cash-out option",
      "required_params": ["rate", "balance"],
      "optional_params": ["years_left", "home_value", "location", "country", "lang"],
      "price_usd": 0.08
    },
    {
      "path": "/api/prop/market",
      "method": "GET",
      "description": "Hyperlocal market: buyer/seller rating, price trends, days on market, inventory — any country",
      "required_params": ["location"],
      "optional_params": ["country", "zip", "lang"],
      "price_usd": 0.10
    },
    {
      "path": "/api/prop/invest",
      "method": "GET",
      "description": "Rental investment analysis — cap rate, cash-on-cash return, gross rent multiplier, break-even occupancy, 5-year appreciation, investment grade, landlord tax flags",
      "required_params": [],
      "optional_params": ["price", "rent", "location", "country", "type", "lang"],
      "price_usd": 0.15
    },
    {
      "path": "/api/prop/valuate",
      "method": "GET",
      "description": "Property valuation (AVM) — estimated value with confidence range, price per sq ft, comparable sales, days-to-sell estimate",
      "required_params": ["address"],
      "optional_params": ["country", "sqft", "beds", "lang"],
      "price_usd": 0.10
    },
    {
      "path": "/api/prop/neighborhood",
      "method": "GET",
      "description": "Neighborhood report — walk score, school context, crime context, median income, price appreciation, area vibe",
      "required_params": ["location"],
      "optional_params": ["country", "zip", "priority", "lang"],
      "price_usd": 0.10
    },
    {
      "path": "/api/prop/first-buyer",
      "method": "GET",
      "description": "First-time homebuyer guide using the buyer's real jurisdiction's schemes (US FHA/VA/USDA/DPA, UK Stamp Duty relief/LISA, CA FHSA/RRSP HBP, AU FHOG/FHSSS, honest no-scheme note for DE)",
      "required_params": [],
      "optional_params": ["income", "savings", "credit", "location", "country", "zip", "lang"],
      "price_usd": 0.10
    },
    {
      "path": "/api/prop/landlord",
      "method": "GET",
      "description": "Landlord toolkit — rent pricing, tenant screening, lease-law summary, eviction timeline, tax flags, local regulations",
      "required_params": ["location"],
      "optional_params": ["country", "zip", "units", "type", "situation", "lang"],
      "price_usd": 0.12
    },
    {
      "path": "/api/prop/rental-market",
      "method": "GET",
      "description": "Rental-market intelligence — asking rent + trend, vacancy tightness, seasonality, deterministic rent-control flag, optional short-term-rental read + regulation flag, budget/hostel rates, deterministic gross-yield math when purchase_price given. Distinct from HomePulse /api/home/rent, this API's own /api/prop/rentbuy, and FindPulse /api/find/rental.",
      "required_params": ["location"],
      "optional_params": ["country", "bedrooms", "purchase_price", "angle", "lang"],
      "price_usd": 0.12
    }
  ],
  "example_queries": [
    "GET /api/prop/mortgage?income=120000&down=60000&location=Austin+TX&country=US",
    "GET /api/prop/afford?income=95000&location=Manchester&country=UK&debt=400",
    "GET /api/prop/rentbuy?rent=2800&location=Seattle+WA&savings=120000&years=7",
    "GET /api/prop/refi?rate=7.5&balance=280000&years_left=26&home_value=450000&country=CA",
    "GET /api/prop/market?location=Bengaluru&country=IN",
    "GET /api/prop/rental-market?location=Manchester&country=UK&purchase_price=250000"
  ],
  "network": "PulseNetwork",
  "sibling_apis": [
    { "name": "WealthPulse", "url": "https://wealthpulse-phi.vercel.app", "relevance": "Broader financial health, debt payoff, retirement planning" },
    { "name": "HomePulse", "url": "https://homepulse-seven.vercel.app", "relevance": "Home improvement ROI, maintenance, single-address fair-rent lookup (/api/home/rent)" }
  ],
  "openapi": "https://proppulse.theaslangroupllc.com/openapi.json",
  "llms_txt": "https://proppulse.theaslangroupllc.com/llms.txt",
  "disclaimer": "For informational purposes only. Not financial or legal advice."
}