# DNSPulse — Full API Documentation

> DNS records (A, AAAA, MX, NS, TXT, CNAME, SOA), TLS certificate, WHOIS (RDAP), CT-log subdomains
> Price: $0.005/query | Protocol: x402 | Networks: Solana + Base

## Endpoints

### /v1/lookup?domain={domain}
- Method: GET
- Price: $0.005 (5000 atomic USDC)
- Auth: PAYMENT-SIGNATURE header (x402) or X-API-Key (AWS Marketplace key)

### /v1/subdomains?domain={domain}
- Method: GET
- Price: $0.005 (5000 atomic USDC)
- Auth: same as /v1/lookup

### /health
- Method: GET
- Price: No auth required
- Returns: { service: "DNSPulse", status: "ok" }

### /llms.txt
- Method: GET
- Price: No auth required
- Returns: Machine-readable service index

## Authentication

### AWS Marketplace key
Subscribe on AWS Marketplace; your key (mp_...) is stored in your AWS Secrets Manager. Send it as X-API-Key (or Authorization: Bearer). A wrong or inactive key answers 401.

### MCP and A2A
- MCP endpoint: https://waltsoft-marketplace-gateway-xncyjgs1uh.gateway.bedrock-agentcore.us-east-1.amazonaws.com/mcp (tool dnspulse___lookupDNS, pass api_key)
- A2A agent card: https://dnspulse.waltsoft.net/.well-known/agent-card.json (JSON-RPC message/send, api_key in params)

### x402 (no account)
1. Make request without payment
2. Parse 402 response PAYMENT-REQUIRED header (base64 JSON)
3. Sign payment authorization (EIP-3009 on Base, SPL transfer on Solana)
4. Retry with PAYMENT-SIGNATURE header

## Payment Details
- Asset: USDC (6 decimals)
- Amount: 5000 atomic = $0.005
- Solana payTo: GsKr5q9TmiJQcEgUpBp2X6SmvSg3dnXuw2uxYJxgPTk8
- Base payTo: 0x318A4B4764eb37c3FCBcE434713128143815FD57
- Solana feePayer: resolved dynamically from GET /platform/v2/x402/supported (CDP fee-payer pool rotates; do not hardcode)

## Provider
Waltsoft · https://waltsoft.net · 16 intelligence APIs for AI agents