Web3 Identity API
1,449 endpoints for Web3 identity resolution, social graphs, DeFi analytics, and blockchain data.
What is Web3 Identity API?
A unified REST API providing comprehensive data about wallets, identities, and protocols in the Web3 ecosystem. Built for developers who need reliable blockchain data without managing dozens of different API providers.
Who is it for?
🔐 Wallet Developers
Display ENS names, avatars, social profiles, and token balances with a single API call.
👥 Social Apps
Build follower graphs, reputation systems, and show mutual connections across protocols.
🤖 AI Agents
Identity verification, trust scoring, and context building for autonomous agents.
📊 DeFi Platforms
Access TVL data, yield opportunities, protocol stats, and price feeds.
🛡️ Security Tools
Token analysis, contract verification, and address risk scoring.
🏗️ dApp Builders
Everything you need to build user-friendly Web3 experiences.
Core Features
| Feature | Description |
|---|---|
| x402 Micropayments | Pay per request with USDC on Base — no subscriptions |
| Free Tier | 100 calls/day free, 200/day with SIWE auth |
| Multi-Source Fallbacks | Aggregates 15+ data providers for reliability |
| OpenAPI Spec | Full Swagger documentation with schemas |
| Web3 Native Auth | Sign-In with Ethereum (SIWE) — no passwords |
API Categories
🆔 Identity Resolution
Resolve ENS names, avatars, and social profiles.
{
"name": "vitalik.eth",
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"avatar": "https://metadata.ens.domains/mainnet/avatar/vitalik.eth",
"records": { ... }
}
| Field | Type | Required | Description |
|---|---|---|---|
name | string | ✅ | ENS name |
address | string | ✅ | Resolved Ethereum address |
avatar | string | ❌ | Avatar URL (if set) |
records | object | ❌ | Text records (twitter, github, url, etc.) |
💰 Market Data
Real-time prices, market caps, and trading data.
{
"symbol": "ETH",
"price": 2847.52,
"change24h": 3.42,
"marketCap": 342000000000,
"volume24h": 15200000000
}
| Field | Type | Required | Description |
|---|---|---|---|
symbol | string | ✅ | Token symbol |
price | number | ✅ | Current USD price |
change24h | number | ✅ | 24h price change % |
marketCap | number | ❌ | Market capitalization |
volume24h | number | ❌ | 24h trading volume |
👛 Wallet Analytics
Balances, transactions, NFTs, and token holdings.
{
"address": "0x...",
"nativeBalance": "1.5",
"tokens": [
{ "symbol": "USDC", "balance": "1000.00", "value": 1000 },
{ "symbol": "UNI", "balance": "50.0", "value": 425 }
],
"totalValue": 5847.50
}
| Field | Type | Required | Description |
|---|---|---|---|
address | string | ✅ | Wallet address |
nativeBalance | string | ✅ | ETH balance |
tokens | array | ✅ | ERC-20 token holdings |
tokens[].symbol | string | ✅ | Token symbol |
tokens[].balance | string | ✅ | Token balance |
tokens[].value | number | ❌ | USD value (if price available) |
totalValue | number | ❌ | Total portfolio value |
📈 DeFi Analytics
TVL, yields, protocol stats, and liquidity data.
{
"name": "Aave",
"tvl": 12500000000,
"chains": ["ethereum", "polygon", "arbitrum"],
"category": "Lending",
"yields": { ... }
}
| Field | Type | Required | Description |
|---|---|---|---|
name | string | ✅ | Protocol name |
tvl | number | ✅ | Total Value Locked (USD) |
chains | array | ✅ | Supported chains |
category | string | ✅ | Protocol category |
yields | object | ❌ | Current yield opportunities |
👥 Social Graphs
Farcaster, Lens, and ENS social connections.
{
"fid": 1234,
"username": "dwr.eth",
"displayName": "Dan Romero",
"bio": "Building @farcaster",
"followers": 125000,
"following": 1500,
"verifications": ["0x..."]
}
| Field | Type | Required | Description |
|---|---|---|---|
fid | number | ✅ | Farcaster ID |
username | string | ✅ | Username |
displayName | string | ❌ | Display name |
bio | string | ❌ | Profile bio |
followers | number | ✅ | Follower count |
following | number | ✅ | Following count |
verifications | array | ❌ | Verified addresses |
Authentication Tiers
| Tier | Rate Limit | How to Access |
|---|---|---|
| Anonymous | 100/day, 10/min | No auth required |
| SIWE | 200/day, 20/min | Sign message with wallet |
| API Key | 250/day | Register at /api/auth/apikey |
| x402 Payment | Unlimited | Pay per request (USDC) |
Quick Start
# No auth needed for basic requests
curl https://api.web3identity.com/api/ens/resolve/vitalik.eth
# Check your rate limit status
curl https://api.web3identity.com/api/usage
Open Swagger UI → to browse all 1,449 endpoints, view full schemas, and test requests live.
Next Steps
📖 Learn
- Quick Start — First request in 2 minutes
- How It Works — Architecture overview
- Pricing — Cost model explained
🛠️ Build
- Code Examples — Copy-paste snippets
- npm SDK — JavaScript client
- Postman Collection — Import & test
Resources
| Resource | URL | Description |
|---|---|---|
| API Docs | api.web3identity.com/api | Swagger UI |
| npm SDK | @atv-eth/x402-sdk | JS/TS client |
| Status | status.web3identity.com | Uptime monitoring |
| Support | support@web3identity.com | Contact us |
Base URL: https://api.web3identity.com
Data provided by this API is for informational purposes only and does not constitute financial, investment, or legal advice. Token prices, DeFi yields, and security scans should be verified independently. Always DYOR.