x402-gateway

Pay-per-lookup data for AI agents. Authoritative Swedish company and vehicle data, paid per call in USDC on Base via the x402 protocol. No account, no contract, no API key — HTTP 402 is the whole onboarding.

payments: on (eip155:8453)Vehicle & representatives endpoints serve labeled fixture data (free) until their licensed sources go live

How it works

GET any paid endpoint → you get 402 Payment Required with payment instructions.
Your x402 client (e.g. @x402/fetch) signs a USDC payment and retries with the PAYMENT header.
The gateway verifies, serves the data, then settles on-chain. Cache hits are instant.

Free endpoints: /api/v1/catalog, /api/v1/se/company/schema, /api/v1/se/vehicle/schema — inspect shapes before paying.

Gateway

Endpoint	Price	What you get
`GET /api/v1/ping` try: /api/v1/ping	$0.001	Paid ping — test the x402 payment flow end-to-end

Sweden (se)

Endpoint	Price	What you get
`GET /api/v1/se/company/{orgnr}` try: /api/v1/se/company/5565550123	$0.005	Swedish company basics by org.nr
`GET /api/v1/se/company/search` try: /api/v1/se/company/search?name=mocktech	$0.01	Search Swedish companies by name
`GET /api/v1/se/company/{orgnr}/annual-report` try: /api/v1/se/company/5565550123/annual-report	$0.02	Swedish annual report key figures (iXBRL), decoded
`GET /api/v1/se/company/{orgnr}/representatives` try: /api/v1/se/company/5565550123/representatives	free free while mock	Board and signatory rule (styrelse + firmateckning)
`GET /api/v1/se/vehicle/{regnr}` try: /api/v1/se/vehicle/ABC123	free free while mock	Swedish vehicle data by registration number
`GET /api/v1/se/vehicle/{regnr}/valuation` try: /api/v1/se/vehicle/ABC123/valuation	free free while mock	Market valuation for a Swedish vehicle

Sources: Bolagsverket, SCB, Vägtrafikregistret (Transportstyrelsen). Data is served with source attribution in every response.

Try it with curl

# Free: inspect the catalog
curl -s ${BASE_URL:-http://localhost:3000}/api/v1/catalog | jq

# Paid: without payment you get the 402 challenge
curl -si ${BASE_URL:-http://localhost:3000}/api/v1/ping | head -20

# Paid with an x402 wallet (see @x402/fetch or the x402:client script)
pnpm x402:client /api/v1/se/company/5565550123