# Domain & Network Lookup

> DNS, WHOIS/RDAP, IP ownership and one-call domain reports. No signup: pay per request with x402 (USDC on Algorand or Base) or with prepaid credits.

Authoritative-source lookups for agents doing research, lead qualification, security triage or ops: DNS records over HTTPS, registry WHOIS via RDAP, IP network ownership with reverse DNS, and a combined domain report (registration, DNS, email provider, SPF/DMARC, hosting).

- GET https://agentpay.agentpay-apis.workers.dev/lookup/v1/dns?name=example.com — Resolve DNS records (A, AAAA, CNAME, MX, NS, TXT, SOA, CAA, PTR, SRV). ($0.005 per call)
    - name (required): Hostname to resolve
    - type: Record type, default A
- GET https://agentpay.agentpay-apis.workers.dev/lookup/v1/whois?domain=example.com — Domain registration data (registrar, created/expires, status, nameservers) via RDAP. ($0.01 per call)
    - domain (required): Domain name
- GET https://agentpay.agentpay-apis.workers.dev/lookup/v1/ip?ip=1.1.1.1 — IP network owner, range, country and reverse DNS. ($0.01 per call)
    - ip (required): IPv4 or IPv6 address
- GET https://agentpay.agentpay-apis.workers.dev/lookup/v1/domain-report?domain=example.com — One-call domain report: registration, DNS, email provider, SPF/DMARC, hosting. ($0.02 per call)
    - domain (required): Domain name

## Payment

Standard x402 v2. Call an endpoint without payment to get HTTP 402 with a base64 PaymentRequired object in the PAYMENT-REQUIRED header, then retry with PAYMENT-SIGNATURE. Any x402 v2 client (e.g. @x402/fetch) works. Invalid input is rejected before payment, and payments are only settled if the call succeeds.

- USDC on Base (eip155:8453), exact scheme (EIP-3009), payTo 0x5d5d827D899CdcaCbD2b2e80162D805B3783C9D8. Settled via facilitator.
- USDC on Algorand (algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73k), exact scheme, ASA 31566704, payTo F2ZYO2DDPQXOACUYBYQIHMQRAB3TJFZVCNUD3OU3CR5OOJUKFZOF5EYVJ4. Send a signed paymentGroup (client pays its own fee); settled directly by this server.

## Prepaid credits (cheapest for repeated use)

- Buy: GET https://agentpay.agentpay-apis.workers.dev/credits/buy?usd=5 — pay once via x402 on either network, receive {"apiKey"}. Any amount $1-$500; bonus credit +10% at $5+, +20% at $20+.
- Or send USDC on Algorand to F2ZYO2DDPQXOACUYBYQIHMQRAB3TJFZVCNUD3OU3CR5OOJUKFZOF5EYVJ4 with note `agentpay:<sha256 hex of a secret>`, then POST https://agentpay.agentpay-apis.workers.dev/credits/redeem {"txid","secret"}.
- Use: header `Authorization: Bearer <apiKey>`. Calls cost the Algorand price. Failed calls are refunded. Balance: GET https://agentpay.agentpay-apis.workers.dev/credits/balance.

## Integrations

- OpenAPI: https://agentpay.agentpay-apis.workers.dev/lookup/openapi.json
- MCP server (Streamable HTTP): https://agentpay.agentpay-apis.workers.dev/lookup/mcp — x402 via params._meta["x402/payment"], or header "Authorization: Bearer <apiKey>"
- x402 index: https://agentpay.agentpay-apis.workers.dev/.well-known/x402
- Docs and example clients: https://github.com/noah-silver/agentpay