# Web3 Identity API - LLM Context
# https://web3identity.com/llms.txt

> Web3 Identity API provides 966 endpoints for ENS resolution, token prices, DeFi data, wallet analytics, and Web3 identity services. Built for developers and AI agents.

## Quick Start

Base URL: https://api.web3identity.com

### Free Tier
- 100 API calls per day
- No authentication required
- Rate limited to 30 requests/minute

### Authentication Options
1. **Anonymous** - 100 calls/day
2. **SIWE (Sign-In with Ethereum)** - 200 calls/day
3. **API Key** - 250 calls/day
4. **x402 Micropayments** - Unlimited (pay per request)

## Core Endpoints

### ENS Resolution
- `GET /api/ens/resolve/{name}` - Resolve ENS name to address
- `GET /api/ens/reverse/{address}` - Reverse resolve address to ENS
- `GET /api/ens/avatar/{name}` - Get ENS avatar
- `GET /api/ens/records/{name}` - Get all text records

### Token Prices
- `GET /api/price/{token}` - Get token price (e.g., ethereum, bitcoin)
- `GET /api/price/batch?tokens=eth,btc` - Batch price lookup
- `GET /api/smart/price/{token}` - Smart price with fallbacks

### Gas Prices
- `GET /api/gas` - Current Ethereum gas prices

### Wallet Data
- `GET /api/wallet/balance/{address}` - Get ETH balance
- `GET /api/address/validate/{address}` - Validate address format

### DeFi
- `GET /api/defi/tvl` - Total DeFi TVL
- `GET /api/defi/{protocol}` - Protocol-specific data (aave, uniswap, etc.)

### Market Data
- `GET /api/market/global` - Global crypto market stats
- `GET /api/market/trending` - Trending tokens

## Documentation

- API Docs: https://docs.web3identity.com
- OpenAPI Spec: https://api.web3identity.com/openapi.json
- Swagger UI: https://api.web3identity.com/api

## Response Format

All endpoints return JSON:
```json
{
  "data": { ... },
  "source": "provider-name",
  "cached": true,
  "timestamp": "2026-02-09T00:00:00.000Z"
}
```

## Error Codes

- `400` - Bad request (invalid parameters)
- `402` - Payment required (free tier exhausted, use x402)
- `404` - Not found
- `429` - Rate limited
- `500` - Server error

## x402 Micropayments

Pay per request with USDC on Base network:
- Micro tier: $0.001/request
- Standard tier: $0.010/request
- Premium tier: $0.050/request

## Contact

- Support: support@web3identity.com
- Documentation: https://docs.web3identity.com
- Status: https://status.web3identity.com

## Legal

- Terms: https://docs.web3identity.com/legal/terms
- Privacy: https://technorealism.com/privacy.html
- SLA: https://docs.web3identity.com/legal/sla