Authentication
Three ways to access the API.
Methods
| Method | Daily Limit | Per Minute | Payment |
|---|---|---|---|
| Anonymous | 100 | 30 | x402 after limit |
| SIWE | 200 | 30 | x402 after limit |
| API Key | 500 | 30 | Prepaid credits |
Anonymous
No authentication required. Default for all requests.
curl https://api.web3identity.com/api/ens/resolve/vitalik.eth
- 100 calls/day per IP
- Rate limited to 30/min
- 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, 30/min
- 200 calls/day per wallet
- Access to
/api/meendpoints - Usage tracking by wallet
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
- 500 calls/day
- Prepurchase credits
- No crypto wallet needed
Which Should I Use?
| Scenario | Recommendation |
|---|---|
| Testing | Anonymous |
| Personal project | SIWE |
| Production app | SIWE + x402 |
| Traditional backend | API Key |
| High volume | API Key + contact us |
Next Steps
- SIWE Details — Full SIWE guide
- API Keys — Create and manage keys
- Rate Limits — Understand limits