{
  "name": "Open Data Proxy",
  "description": "Pay $0.01 USDC per call to validate IBANs, EU VAT numbers and Dutch postcodes, and to query CBS housing, company, domain and EU sanctions data on Base Mainnet.",
  "baseUrl": "https://cbs.thesoulnetwork.eu",
  "version": "1.0.0",
  "endpoints": [
    {
      "route": "/iban",
      "method": "GET",
      "description": "Use GET /iban?value=… to check checksum validity and retrieve bank name, country and BIC.",
      "price": "$0.01 USDC",
      "representativeQueries": [
        "validate an IBAN checksum",
        "look up the bank name and BIC for an IBAN"
      ]
    },
    {
      "route": "/vat",
      "method": "GET",
      "description": "Use GET /vat?value=… to validate a VAT number against the EU VIES service. Responses are cached for 24h.",
      "price": "$0.01 USDC",
      "representativeQueries": [
        "validate an EU VAT number",
        "check if a VAT number is registered in VIES"
      ]
    },
    {
      "route": "/postcode",
      "method": "GET",
      "description": "Use GET /postcode?code=…&number=… to expand a Dutch postcode into street, city, municipality, province and coordinates.",
      "price": "$0.01 USDC",
      "representativeQueries": [
        "look up a Dutch address from a postcode",
        "find the street and city for a Dutch postcode"
      ]
    },
    {
      "route": "/cbs/housing-snapshot",
      "method": "GET",
      "description": "Use GET /cbs/housing-snapshot?postcode=… to read median WOZ value, transaction volume and price trend from CBS table 85773NED.",
      "price": "$0.01 USDC",
      "representativeQueries": [
        "get the median WOZ value for a Dutch postcode",
        "check housing transaction volume by postcode"
      ]
    },
    {
      "route": "/cbs/enrich",
      "method": "GET",
      "description": "Use GET /cbs/enrich?name=…&city=… to assemble CBS open data and a DNS heuristic into a company profile (BAG address, SBI codes, employee bracket). Not KVK-accurate.",
      "price": null,
      "representativeQueries": [
        "enrich a Dutch company name with address and SBI codes",
        "look up a Dutch company profile from name and city"
      ],
      "status": "coming_soon"
    },
    {
      "route": "/domain/bundle",
      "method": "GET",
      "description": "Use GET /domain/bundle?domain=… to bundle RDAP registration data, MX/SPF/DMARC mail grading, SSL expiry and a tech-stack heuristic into one call.",
      "price": "$0.01 USDC",
      "representativeQueries": [
        "research a domain's age and mail security",
        "check a domain's RDAP, MX and SPF records"
      ]
    },
    {
      "route": "/sanctions",
      "method": "GET",
      "description": "Use GET /sanctions?name=… to fuzzy-match a name against the EU consolidated sanctions list and return a confidence score plus the matched entity.",
      "price": "$0.01 USDC",
      "representativeQueries": [
        "check an entity against the EU sanctions list",
        "screen a name for sanctions matches"
      ]
    }
  ]
}