Districts

{
  "district": "LS6",
  "locations": [
    {
      "attribution": "Contains HM Land Registry data © Crown copyright and database right 2026. Contains public sector information licensed under the Open Government Licence v3.0.",
      "buyToLetPurchaseTax": {
        "atPriceGbp": 152000,
        "taxName": "Stamp Duty Land Tax",
        "totalGbp": 8140
      },
      "center": {
        "lat": 53.8139,
        "lng": -1.532
      },
      "entryPriceGbp": 152000,
      "grossYield": {
        "basis": "ons_authority_type_matched",
        "grossPct": 7.2,
        "measuredAcross": "Leeds",
        "monthlyRentGbp": 900,
        "propertyType": "flat"
      },
      "id": "leeds",
      "intelligence": {
        "councilTaxBandABPct": 61.5,
        "degreePct": 34.6,
        "gigabitBroadbandPct": 94,
        "householdIncomeAfterHousing": 33217,
        "householdIncomeYear": "FYE 2023",
        "privateRentedPct": 22.9
      },
      "localAuthority": "Leeds",
      "mapUrl": "https://claritypropertyinvestments.com/tools/investment-map",
      "name": "Leeds",
      "nation": "england",
      "postcodeDistricts": [
        "LS1",
        "LS10",
        "LS11",
        "LS12",
        "LS13"
      ],
      "summary": [
        "Flats across Leeds let for £900/mo against a median sale of £150,000 there: 7.2% gross before costs, on ONS rents and sold prices for the whole authority."
      ]
    }
  ],
  "notes": [
    "Figures are the Clarity ranking dataset's, regenerated monthly. Authority-grain figures (yield, growth, population, housing delivery) are the named local authority's, not the town's.",
    "A field that is absent was not measured for this place. Absent is not zero.",
    "Research, not regulated financial advice. The full location report is sold separately at claritypropertyinvestments.com."
  ],
  "publisher": "Clarity Property Investments"
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://claritypropertyinvestments.com/api/v1/districts/:district'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://claritypropertyinvestments.com/api/v1/districts/:district' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.1 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.1" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.1 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fclaritypropertyinvestments.com%2Fapi%2Fv1%2Fdistricts%2F%3Adistrict
const res = await pay("https://claritypropertyinvestments.com/api/v1/districts/:district");
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.1 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.1"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://claritypropertyinvestments.com/api/v1/districts/:district")
    print(res.status_code, res.text)