Bloomfilter | Bloomfilter

# Bloomfilter API — AI Agent Reference > Domain registration API for AI agents. Pay with USDC on Base L2 via x402 protocol. Base URL: https://api.bloomfilter.xyz Auth: SIWE (Sign-In With Ethereum) — JWT Bearer tokens Payments: x402 protocol — USDC on Base (eip155:8453) OpenAPI spec: https://docs.bloomfilter.xyz/openapi.json Docs: https://docs.bloomfilter.xyz ## Endpoints ### Public (no auth, no payment) GET /health — Service health check (DB, Redis, registrar status) GET /.well-known/agent-card.json — ERC-8004 agent discovery card GET /domains/search?query={q}&tlds={tlds} — Search domain availability (60/min) GET /domains/pricing — All TLD pricing (registration, renewal, transfer in USD) GET /domains/pricing/{tld} — Single TLD pricing GET /domains/{domain} — Domain info (status, expiry, nameservers) GET /domains/status/{jobId} — Poll async job status (200=done, 202=pending) ### Payment required (x402, no auth needed) POST /domains/register — Register domain. Body: {domain, years?, dns_records?}. Price varies by TLD. 402→pay→201/202. (10/day) POST /domains/renew — Renew domain. Body: {domain, years?}. Price varies by TLD. 402→pay→200. (10/day) ### Auth required (SIWE JWT) GET /auth/nonce — Get SIWE nonce (30/min) POST /auth/verify — Verify SIWE signature. Body: {message, signature}. Returns JWT tokens. (30/min) POST /auth/refresh — Refresh JWT. Body: {refreshToken}. (30/min) POST /auth/revoke — Revoke all sessions. (30/min) ### Auth + payment (SIWE JWT + x402 $0.10) POST /dns/{domain} — Add DNS record. Body: {type, host, value, ttl?, priority?}. $0.10. (100/hr) PUT /dns/{domain}/{recordId} — Update DNS record. Body: {host?, value?, ttl?, priority?}. $0.10. (100/hr) DELETE /dns/{domain}/{recordId} — Delete DNS record. $0.10. (100/hr) ### Auth required (SIWE JWT, free) GET /dns/{domain} — List DNS records. (100/hr) GET /account — Account summary (wallet, spend, domains count) GET /account/domains?limit=50&o

{ "openapi": "3.1.0", "info": { "title": "Bloomfilter API", "version": "1.0.0", "description": "Domain registration API for AI agents. Register ICANN domain names and manage DNS records, paying with USDC stablecoins via the x402 protocol. No login, no credit card, no KYC — just HTTP requests and a crypto wallet.", "contact": { "name": "Bloomfilter", "url": "https://bloomfilter.xyz" }, "license": { "name": "Proprietary" } }, "servers": [