EN
France property & address · x402

dvf-price-m2

French property price per m2 around an address from official DVF sales records (DGFiP / Etalab, last 3 years): median, p25/p75, count for apartments and houses within an auto-expanding radius, geocoded via Base Adresse Nationale. Not available for Alsace-Moselle and Mayotte.

0.01 USDC / call · {atomic} atomic · 10000 atomic

Endpoint

GET|POST https://x402-gateway.forge-x402.workers.dev/api/dvf-price-m2
MCP tool:: dvf_price_m2

Parameters

NameRequiredTypeDescription
addressRequiredstringFrench street address
propertyTypeOptionalstringoptional: Appartement or Maison
surfaceOptionalnumberoptional surface in m2 for an estimate

Example request (unpaid — expect 402)

curl -sS -D - "https://x402-gateway.forge-x402.workers.dev/api/dvf-price-m2?address=10+rue+de+la+Paix%2C+Paris"

Example 402 challenge

The same object is also sent as a base64 PAYMENT-REQUIRED header. Amounts are atomic USDC units (6 decimals).

{
  "x402Version": 2,
  "error": "Payment required",
  "resource": {
    "url": "https://x402-gateway.forge-x402.workers.dev/api/dvf-price-m2",
    "description": "French property price per m2 around an address from official DVF sales records (DGFiP / Etalab, last 3 years): median, p25/p75, count for apartments and houses within an auto-expanding radius, geocoded via Base Adresse Nationale. Not available for Alsace-Moselle and Mayotte.",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "10000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x7B8bf45ac6AcbA6D4CFB626b57D3f5fF3C9C89F7",
      "maxTimeoutSeconds": 120,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ]
}

Retry with payment

curl -sS "https://x402-gateway.forge-x402.workers.dev/api/dvf-price-m2?address=10+rue+de+la+Paix%2C+Paris" \
  -H "PAYMENT-SIGNATURE: $PAYMENT"

Example response

{
  "found": true,
  "geocodedLabel": "10 Rue de la Paix 75002 Paris",
  "apartmentMedianPricePerM2": 12857,
  "apartmentSales": 381,
  "houseMedianPricePerM2": 17846,
  "houseSales": 12
}

Related Apify Actors

Related endpoints