# Open Data Proxy

> 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.

Base URL: https://cbs.thesoulnetwork.eu

## Payment

$0.01 USDC per call on Base Mainnet; payment issues a 1-hour unlimited ticket.
Network: base-mainnet (chainId 8453), USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.
No API key. Humans and agents pay the same flat rate; a valid JWT ticket
passes free for 1 hour.

## Endpoints

### /health
Unprotected health check. Returns 200 without payment.
Price: Free

### How do I validate an IBAN?
Use GET /iban?value=… to check checksum validity and retrieve bank name, country and BIC.
Example: GET /iban?value=NL91ABNA0417164300
Price: $0.01 USDC

### How do I validate an EU VAT number?
Use GET /vat?value=… to validate a VAT number against the EU VIES service. Responses are cached for 24h.
Example: GET /vat?value=NL852378361B01
Price: $0.01 USDC

### How do I look up a Dutch address from a postcode?
Use GET /postcode?code=…&number=… to expand a Dutch postcode into street, city, municipality, province and coordinates.
Example: GET /postcode?code=1012AB&number=1
Price: $0.01 USDC

### What is the housing market like in a Dutch postcode?
Use GET /cbs/housing-snapshot?postcode=… to read median WOZ value, transaction volume and price trend from CBS table 85773NED.
Example: GET /cbs/housing-snapshot?postcode=1012AB
Price: $0.01 USDC

### How do I enrich a Dutch company name with address and SBI codes?
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.
Example: GET /cbs/enrich?name=Acme&city=Amsterdam
Price: $0.01 USDC
Status: coming soon — not available yet, no payment accepted.

### How do I research a domain's age, mail security and tech stack?
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.
Example: GET /domain/bundle?domain=example.com
Price: $0.01 USDC

### Is this entity on the EU sanctions list?
Use GET /sanctions?name=… to fuzzy-match a name against the EU consolidated sanctions list and return a confidence score plus the matched entity.
Example: GET /sanctions?name=Putin
Price: $0.01 USDC

## Docs

- Full docs: https://cbs.thesoulnetwork.eu/llms-full.txt
- /iban: https://cbs.thesoulnetwork.eu/iban.md
- /vat: https://cbs.thesoulnetwork.eu/vat.md
- /postcode: https://cbs.thesoulnetwork.eu/postcode.md
- /cbs/housing-snapshot: https://cbs.thesoulnetwork.eu/cbs-housing-snapshot.md
- /cbs/enrich: https://cbs.thesoulnetwork.eu/cbs-enrich.md
- /domain/bundle: https://cbs.thesoulnetwork.eu/domain-bundle.md
- /sanctions: https://cbs.thesoulnetwork.eu/sanctions.md