Deal signals as they happen.

# Step 1: pull the property record for a shortlisted UPRN (1 token)
curl "https://api.homedata.co.uk/properties/100023456789/" \
  -H "Authorization: Api-Key YOUR_API_KEY"
  # returns bedrooms, floor_area, tenure, construction_age, sold_price_history

# Step 2: comparable sales within 0.5 miles (arranged per customer, not self-serve)
curl "https://api.homedata.co.uk/comparables/100023456789/" \
  -H "Authorization: Api-Key YOUR_API_KEY"
  # returns up to 200 comps: anchor your BMV offer

import requests

API_KEY = "YOUR_API_KEY"
BASE    = "https://api.homedata.co.uk"
HEADERS = {"Authorization": f"Api-Key {API_KEY}"}

def assess_deal(uprn: str, asking: int) -> dict:
    # Step 1: property record (1 token)
    record = requests.get(
        f"{BASE}/properties/{uprn}/",
        headers=HEADERS
    ).json()

    # Step 2: comparable sales (arranged per customer, not self-serve)
    comps = requests.get(
        f"{BASE}/comparables/{uprn}/",
        headers=HEADERS,
        params={"count": 20, "event_type": "sold"}
    ).json().get("comparables", [])

    avg_comp = (
        sum(c["sold_let_price"] for c in comps) / len(comps)
        if comps else None
    )
    discount = round((1 - asking / avg_comp) * 100, 1) if avg_comp else None

    return {
        "uprn":         uprn,
        "asking":       asking,
        "avg_comp":     avg_comp,
        "discount_pct": discount,
        "bedrooms":     record.get("bedrooms"),
        "floor_area":   record.get("floor_area_sqm"),
    }

# UPRNs and asking prices from your own sourcing, or from an Explore reveal
shortlist = {"100023456789": 285000, "100023456790": 410000}

deals = sorted(
    (assess_deal(uprn, asking) for uprn, asking in shortlist.items()),
    key=lambda d: d["discount_pct"] or 0,
    reverse=True,
)
for d in deals:
    print(f"UPRN {d['uprn']}: £{d['asking']:,} | {d['discount_pct']}% BMV")

const API_KEY = 'YOUR_API_KEY';
const BASE    = 'https://api.homedata.co.uk';
const headers = { 'Authorization': `Api-Key ${API_KEY}` };

// UPRNs and asking prices from your own sourcing, or from an Explore reveal
const shortlist = [
  { uprn: '100023456789', asking: 285000 },
  { uprn: '100023456790', asking: 410000 },
];

async function assessDeals(properties) {
  const assessed = await Promise.all(
    properties.map(async ({ uprn, asking }) => {
      // Steps 1 + 2: property record (1 token) + comps (arranged per customer), in parallel
      const [recordResp, compsResp] = await Promise.all([
        fetch(`${BASE}/properties/${uprn}/`, { headers }),
        // comparables: arranged per customer, not self-serve
        fetch(`${BASE}/comparables/${uprn}/?count=20&event_type=sold`, { headers }),
      ]);

      const record           = await recordResp.json();
      const { comparables }  = await compsResp.json();

      const avgComp    = comparables.reduce((s, c) => s + c.sold_let_price, 0) / comparables.length;
      const discountPct = ((1 - asking / avgComp) * 100).toFixed(1);

      return {
        uprn,
        asking,
        avgComp:     Math.round(avgComp),
        discountPct,
        bedrooms:    record.bedrooms,
      };
    })
  );

  return assessed.sort((a, b) => b.discountPct - a.discountPct);
}

assessDeals(shortlist).then(deals =>
  deals.forEach(d =>
    console.log(`UPRN ${d.uprn}: £${d.asking.toLocaleString()} | ${d.discountPct}% BMV`)
  )
);