DNSlurp API

When rate limited, you have two options: wait for the free tier to reset, or pay for unlimited access.

// Option 1: Wait (free path — treat 402 like a 429)
const res = await fetch('/api/lookup?domains=google.com&type=A');

if (res.status === 402 || res.status === 429) {
  const data = await res.json();
  const waitSeconds = data.retryAfter || 60;
  console.log(`Rate limited. Retrying in ${waitSeconds}s`);
  await new Promise(r => setTimeout(r, waitSeconds * 1000));
  // retry...
}

// Option 2: Pay (see Pay-Through Access section below)

On your 31st request in a minute, you receive:

HTTP/1.1 402 Payment Required
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 45
Retry-After: 45
Payment-Required: eyJ4NDAy...

{
  "x402Version": 2,
  "error": "Rate limit exceeded.",
  "accepts": [{
    "scheme": "exact",
    "network": "eip155:8453",
    "amount": "10000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "description": "DNSlurp: 1-hour elevated rate limits"
  }],
  "message": "Pay $0.01 USDC to get 1 hour of unlimited access.",
  "retryAfter": 45
}

Free path: Wait retryAfter seconds and continue using the API at no cost.
Paid path: Sign an x402 payment and send it on your next request.

Use the @x402/fetch library to handle payment automatically. It wraps fetch, intercepts 402 responses, signs the payment with your wallet, and retries:

// Install: npm install @x402/fetch @x402/evm
import { wrapFetchWithPaymentFromConfig } from '@x402/fetch';
import { ExactEvmScheme } from '@x402/evm';

const payingFetch = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{
    network: 'eip155:8453',
    client: new ExactEvmScheme(walletAccount),
  }],
});

// This auto-pays if rate limited
const response = await payingFetch(
  'https://dnslurp.esoup.net/api/lookup?domains=esoup.net&type=A'
);

Or manually: include the signed payment in a Payment-Signature header.

After successful payment, the server returns:

HTTP/1.1 200 OK
X-Paid-Access: granted

{
  "message": "Payment accepted. Use this API key for 1 hour of elevated access.",
  "accessToken": "eyJhbGciOiJIUzI1...",
  "expiresAt": "2026-02-19T08:00:00.000Z",
  "usage": "Include as Authorization: Bearer <accessToken> in subsequent requests."
}

Include the token as a Bearer token in subsequent requests. Rate limits are bypassed for 1 hour:

curl -H "Authorization: Bearer eyJhbGciOiJIUzI1..." \
  "https://dnslurp.esoup.net/api/lookup?domains=esoup.net&type=A"

# Response headers confirm paid status:
# X-Paid-Access: active
# X-Paid-Expires: 2026-02-19T08:00:00.000Z

When the token expires, you drop back to the free tier. No subscription. Pay again when you need to.