Skip to main content

Authentication

Three ways to access the API.

Methods​

MethodDaily LimitPer MinutePayment
Anonymous10030x402 after limit
SIWE20030x402 after limit
API Key25030Prepaid credits

Anonymous​

No authentication required. Default for all requests.

curl https://api.web3identity.com/api/ens/resolve/vitalik.eth
  • 100 calls/day per IP
  • Standard rate limits apply
  • Pay via x402 after exhaustion

SIWE (Sign-In with Ethereum)​

Sign a message with your wallet to double limits.

const client = new ATVClient({
  privateKey: process.env.WALLET_KEY,
});

await client.signIn();
// Now: 200 calls/day
  • 200 calls/day per wallet
  • Access to /api/me endpoints
  • Higher daily limit

API Keys​

Prepaid credits for high-volume or traditional apps.

curl -H "X-API-Key: atv_yourkey" \
  https://api.web3identity.com/api/ens/resolve/vitalik.eth
  • 250 calls/day
  • Prepurchase credits
  • No crypto wallet needed

Which Should I Use?​

ScenarioRecommendation
TestingAnonymous
Personal projectSIWE
Production appSIWE + x402
Traditional backendAPI Key
High volumeAPI Key + contact us

Next Steps​