# Web3 Identity API - Comprehensive LLM Context
# https://web3identity.com/llms-full.txt
# Last updated: 2026-02-09

> Web3 Identity API provides 966+ endpoints for ENS resolution, token prices, DeFi data, wallet analytics, and Web3 identity services. This comprehensive guide covers all endpoints, authentication methods, and usage patterns.

## Overview

- **Base URL:** https://api.web3identity.com
- **Total Endpoints:** 966+
- **Response Format:** JSON
- **Documentation:** https://docs.web3identity.com
- **OpenAPI Spec:** https://api.web3identity.com/openapi.json
- **Swagger UI:** https://api.web3identity.com/api

---

## Authentication

### Tier 1: Anonymous (No Auth)
- **Limit:** 100 requests/day per IP
- **Rate:** 30 requests/minute
- **Usage:** Just call the endpoint

```bash
curl https://api.web3identity.com/api/ens/resolve/vitalik.eth
```

### Tier 2: SIWE (Sign-In with Ethereum)
- **Limit:** 200 requests/day
- **Rate:** 60 requests/minute
- **Usage:** Sign message with wallet, include session cookie

```bash
# 1. Get nonce
curl https://api.web3identity.com/api/auth/nonce

# 2. Sign message with wallet (client-side)

# 3. Verify signature
curl -X POST https://api.web3identity.com/api/auth/verify \
  -H "Content-Type: application/json" \
  -d '{"message": "...", "signature": "0x..."}'
```

### Tier 3: API Key
- **Limit:** 250 requests/day
- **Rate:** 60 requests/minute
- **Usage:** Include header `X-API-Key: your-key`

```bash
curl https://api.web3identity.com/api/ens/resolve/vitalik.eth \
  -H "X-API-Key: your-api-key"
```

### Tier 4: x402 Micropayments (Unlimited)
- **Limit:** Unlimited
- **Rate:** 120 requests/minute
- **Payment:** USDC on Base network
- **Usage:** Sign EIP-712 payment, include in header

```bash
# Response includes 402 with payment details
# Sign payment with wallet, resend with X-Payment header
```

---

## Endpoint Categories

### ENS Resolution
Resolve Ethereum Name Service names and records.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/ens/resolve/{name}` | GET | Resolve ENS name to Ethereum address |
| `/api/ens/reverse/{address}` | GET | Reverse resolve address to ENS name |
| `/api/ens/avatar/{name}` | GET | Get ENS avatar URL |
| `/api/ens/records/{name}` | GET | Get all text records for ENS name |
| `/api/ens/resolver/{name}` | GET | Get resolver contract address |
| `/api/ens/expiration/{name}` | GET | Get expiration date |
| `/api/ens/value/{name}` | GET | Get estimated value |
| `/api/avatar/{name}` | GET | Shorthand for avatar |

**Example:**
```bash
curl https://api.web3identity.com/api/ens/resolve/vitalik.eth
# {"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","source":"ens","timestamp":"..."}
```

### Token Prices
Real-time cryptocurrency prices from multiple sources.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/price/{token}` | GET | Get token price (e.g., ethereum, bitcoin) |
| `/api/price/batch` | GET | Batch price lookup (?tokens=eth,btc) |
| `/api/smart/price/{token}` | GET | Smart price with automatic fallbacks |
| `/api/smart/prices` | GET | Multiple smart prices |

**Example:**
```bash
curl https://api.web3identity.com/api/price/ethereum
# {"price":2076.69,"change24h":2.5,"source":"coingecko","timestamp":"..."}
```

### Gas Prices
Current gas prices across networks.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/gas` | GET | Ethereum gas prices (slow, standard, fast) |
| `/api/chains/l2/fees` | GET | L2 gas comparison |

**Example:**
```bash
curl https://api.web3identity.com/api/gas
# {"slow":15,"standard":20,"fast":30,"source":"etherscan","timestamp":"..."}
```

### Wallet & Address
Wallet analytics and address utilities.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/wallet/balance/{address}` | GET | Get ETH balance |
| `/api/address/validate/{address}` | GET | Validate address format |
| `/api/address/checksum/{address}` | GET | Get checksummed address |
| `/api/address/type/{address}` | GET | Detect address type (EOA/contract) |
| `/api/address/iscontract/{address}` | GET | Check if address is contract |
| `/api/address/age/{address}` | GET | Get wallet age |

**Example:**
```bash
curl https://api.web3identity.com/api/wallet/balance/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
# {"balance":1234.56,"unit":"ETH","source":"rpc","timestamp":"..."}
```

### DeFi Data
Decentralized finance protocol data.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/defi/tvl` | GET | Total DeFi TVL |
| `/api/defi/{protocol}` | GET | Protocol data (aave, uniswap, lido, etc.) |
| `/api/yields/top` | GET | Top yield opportunities |
| `/api/lending/{protocol}` | GET | Lending protocol data |
| `/api/staking/{protocol}` | GET | Staking protocol data |

**Supported Protocols:** aave, uniswap, lido, curve, compound, makerdao, convex, eigenlayer, rocket-pool, frax, yearn, balancer, sushiswap, pancakeswap, gmx, dydx, synthetix, instadapp, morpho, spark

**Example:**
```bash
curl https://api.web3identity.com/api/defi/aave
# {"name":"Aave","tvl":27800000000,"chains":["ethereum","polygon"],"source":"defillama","timestamp":"..."}
```

### Market Data
Global crypto market statistics.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/market/global` | GET | Global market stats |
| `/api/market/trending` | GET | Trending tokens |
| `/api/market/movers` | GET | Top gainers/losers |
| `/api/market/fear-greed` | GET | Fear & Greed index |
| `/api/market/dominance` | GET | BTC/ETH dominance |

**Example:**
```bash
curl https://api.web3identity.com/api/market/global
# {"totalMarketCap":2500000000000,"btcDominance":52.3,"source":"coingecko","timestamp":"..."}
```

### Chain Data
Multi-chain statistics and status.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/chains` | GET | List all supported chains |
| `/api/chains/overview` | GET | Chain TVL overview |
| `/api/chains/{chain}/stats` | GET | Chain-specific stats |
| `/api/network/{chain}/status` | GET | Network health status |

**Supported Chains:** ethereum, arbitrum, optimism, base, polygon, avalanche, bsc, fantom, gnosis, linea, scroll, zksync, mantle, blast, solana, sui, aptos, near, cosmos

### Social / Identity
Web3 social and identity data.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/farcaster/{identifier}` | GET | Farcaster profile |
| `/api/farcaster/trending` | GET | Trending Farcaster content |
| `/api/lens/health` | GET | Lens API status |
| `/api/lens/address/{address}` | GET | Lens profile by address |

### NFT Data
NFT collections and marketplace data.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/nft/collections` | GET | Top NFT collections |
| `/api/nft/trending` | GET | Trending NFTs |
| `/api/nft/marketplaces` | GET | Marketplace volumes |
| `/api/alchemy/nfts/{address}` | GET | NFTs owned by address |

### DEX & Aggregators
Decentralized exchange data.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/dex/list` | GET | List of DEX protocols |
| `/api/dex/{protocol}` | GET | DEX-specific data |
| `/api/aggregators` | GET | DEX aggregator volumes |
| `/api/aggregator/{name}` | GET | Aggregator-specific data |

### Bridges
Cross-chain bridge data.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/bridges` | GET | List of bridges with volumes |
| `/api/bridge/{name}` | GET | Bridge-specific data |

### Stablecoins
Stablecoin market data.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/stablecoins/marketcap` | GET | Total stablecoin market cap |
| `/api/stablecoins/prices` | GET | Stablecoin prices |
| `/api/usdc` | GET | USDC data |
| `/api/usdt` | GET | USDT data |
| `/api/dai` | GET | DAI data |

### Bitcoin
Bitcoin network statistics.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/bitcoin/ticker` | GET | BTC price ticker |
| `/api/bitcoin/stats` | GET | Network statistics |
| `/api/bitcoin/hashrate` | GET | Network hashrate |
| `/api/bitcoin/difficulty` | GET | Mining difficulty |
| `/api/bitcoin/blockcount` | GET | Current block height |

### Conversion
Currency conversion utilities.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/convert/{from}/{to}` | GET | Convert between currencies |
| `/api/convert/eth/usd` | GET | ETH to USD |
| `/api/convert/rates` | GET | Exchange rate table |
| `/api/convert/gwei/{amount}` | GET | Gwei to ETH |
| `/api/convert/wei/{amount}` | GET | Wei to ETH |

### Safe (Multisig)
Gnosis Safe multisig data.

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/safe/info/{address}` | GET | Safe info |
| `/api/safe/balances/{address}` | GET | Safe balances |
| `/api/safe/transactions/{address}` | GET | Safe transactions |
| `/api/safe/owners/{address}` | GET | Safe owners |

---

## Response Format

All endpoints return JSON with consistent structure:

### Success Response
```json
{
  "data": { ... },
  "source": "provider-name",
  "cached": true,
  "cachedAt": "2026-02-09T00:00:00.000Z",
  "timestamp": "2026-02-09T00:00:00.000Z"
}
```

### Error Response
```json
{
  "error": true,
  "code": "ERROR_CODE",
  "message": "Human readable message",
  "timestamp": "2026-02-09T00:00:00.000Z"
}
```

### Error Codes

| Code | HTTP | Description |
|------|------|-------------|
| `BAD_REQUEST` | 400 | Invalid parameters |
| `PAYMENT_REQUIRED` | 402 | Free tier exhausted, use x402 |
| `NOT_FOUND` | 404 | Resource not found |
| `RATE_LIMITED` | 429 | Too many requests |
| `SERVER_ERROR` | 500 | Internal server error |

---

## x402 Micropayments

### Pricing Tiers

| Tier | Price/Request | Endpoints |
|------|---------------|-----------|
| Micro | $0.001 | /api/gas, /api/avatar/*, /api/atv |
| Small | $0.010 | /api/ens/*, /api/price/*, /api/reverse/* |
| Medium | $0.020 | /api/prices, /api/defi/*, /api/farcaster/* |
| Premium | $0.050 | /api/profile/* |

### Payment Flow

1. Call endpoint, receive 402 with payment details
2. Sign EIP-712 typed data with your wallet
3. Resend request with `X-Payment` header
4. Payment settles in USDC on Base network

---

## Rate Limits

| Tier | Daily Limit | Per Minute |
|------|-------------|------------|
| Anonymous | 100 | 30 |
| SIWE | 200 | 60 |
| API Key | 250 | 60 |
| x402 | Unlimited | 120 |

---

## SDKs & Tools

- **npm:** `@ATV_eth/x402-sdk`
- **OpenAPI:** https://api.web3identity.com/openapi.json
- **Postman:** https://api.web3identity.com/postman

---

## Support

- **Email:** support@web3identity.com
- **Documentation:** https://docs.web3identity.com
- **Status:** https://status.web3identity.com
- **Twitter:** @ATV_eth

---

## Legal

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

---

# Full Endpoint List

Below is the complete list of available endpoints organized alphabetically by path.

## /api/address/*
- GET /api/address/age/{address} - Get wallet age
- POST /api/address/batch/type - Batch address type detection
- POST /api/address/batch/validate - Batch address validation
- GET /api/address/checksum/{address} - Get checksummed address
- GET /api/address/code/{address} - Get contract bytecode
- GET /api/address/iscontract/{address} - Check if contract
- GET /api/address/type/{address} - Detect address type
- GET /api/address/validate/{address} - Validate address

## /api/aggregator/*
- GET /api/aggregators - All aggregator volumes
- GET /api/aggregator/1inch - 1inch stats
- GET /api/aggregator/bebop - Bebop stats
- GET /api/aggregator/cowswap - CoW Swap stats
- GET /api/aggregator/jupiter - Jupiter stats
- GET /api/aggregator/kyberswap - KyberSwap stats
- GET /api/aggregator/matcha - Matcha stats
- GET /api/aggregator/odos - Odos stats
- GET /api/aggregator/openocean - OpenOcean stats
- GET /api/aggregator/paraswap - ParaSwap stats
- GET /api/aggregator/socket - Socket stats

## /api/alchemy/*
- GET /api/alchemy/balances/{address} - Token balances
- GET /api/alchemy/collection/{contract} - NFT collection
- GET /api/alchemy/contracts/{address} - Deployed contracts
- GET /api/alchemy/floor/{contract} - Floor price
- GET /api/alchemy/holders/{contract} - Token holders
- GET /api/alchemy/nft/{contract}/{tokenId} - NFT metadata
- GET /api/alchemy/nfts/{address} - Owned NFTs
- GET /api/alchemy/owners/{contract} - NFT owners
- GET /api/alchemy/sales/{contract} - NFT sales
- GET /api/alchemy/spam/{contract} - Spam check
- GET /api/alchemy/token/{contract} - Token metadata
- GET /api/alchemy/transfers/{address} - Token transfers

## /api/auth/*
- GET /api/auth/nonce - Get SIWE nonce
- POST /api/auth/verify - Verify SIWE signature
- GET /api/auth/me - Get current session
- GET /api/auth/session - Session info
- POST /api/auth/logout - End session

## /api/bitcoin/*
- GET /api/bitcoin/ticker - Price ticker
- GET /api/bitcoin/stats - Network stats
- GET /api/bitcoin/hashrate - Hashrate
- GET /api/bitcoin/difficulty - Difficulty
- GET /api/bitcoin/blockcount - Block height
- GET /api/bitcoin/24hrprice - 24h weighted price
- GET /api/bitcoin/24hrtransactioncount - 24h TX count
- GET /api/bitcoin/marketcap - Market cap
- GET /api/bitcoin/totalbc - Total supply

## /api/bridge/*
- GET /api/bridges - All bridges
- GET /api/bridge/across - Across stats
- GET /api/bridge/cbridge - cBridge stats
- GET /api/bridge/hop - Hop stats
- GET /api/bridge/stargate - Stargate stats
- GET /api/bridge/synapse - Synapse stats
- GET /api/bridge/wormhole - Wormhole stats

## /api/chains/*
- GET /api/chains - List chains
- GET /api/chains/overview - Chain TVL overview
- GET /api/chains/fees - Chain fees
- GET /api/chains/l2/overview - L2 overview
- GET /api/chains/l2/fees - L2 fees comparison
- GET /api/chains/{chain}/stats - Chain stats
- GET /api/chains/{chain}/tvl - Chain TVL history
- GET /api/chains/{chain}/protocols - Chain protocols

## /api/convert/*
- GET /api/convert/{from}/{to} - Currency conversion
- GET /api/convert/eth/usd - ETH to USD
- GET /api/convert/btc/usd - BTC to USD
- GET /api/convert/rates - Rate table
- GET /api/convert/gwei/{amount} - Gwei to ETH
- GET /api/convert/wei/{amount} - Wei to ETH

## /api/defi/*
- GET /api/defi/tvl - Total DeFi TVL
- GET /api/defi/aave - Aave stats
- GET /api/defi/uniswap - Uniswap stats
- GET /api/defi/lido - Lido stats
- GET /api/defi/curve - Curve stats
- GET /api/defi/compound - Compound stats
- GET /api/defi/makerdao - MakerDAO stats
- GET /api/defi/eigenlayer - EigenLayer stats
- GET /api/defi/gmx - GMX stats
- GET /api/defi/dydx - dYdX stats
(+ 50 more protocols)

## /api/dex/*
- GET /api/dex/list - All DEXes
- GET /api/dex/uniswap - Uniswap stats
- GET /api/dex/curve - Curve stats
- GET /api/dex/pancakeswap - PancakeSwap stats
- GET /api/dex/sushiswap - SushiSwap stats
- GET /api/dex/balancer - Balancer stats
(+ 20 more DEXes)

## /api/ens/*
- GET /api/ens/resolve/{name} - Resolve to address
- GET /api/ens/reverse/{address} - Reverse resolve
- GET /api/ens/avatar/{name} - Get avatar
- GET /api/ens/records/{name} - Get text records
- GET /api/ens/resolver/{name} - Get resolver
- GET /api/ens/expiration/{name} - Get expiration
- GET /api/ens/value/{name} - Get estimated value

## /api/farcaster/*
- GET /api/farcaster/{identifier} - Profile by FID or username
- GET /api/farcaster/trending - Trending content
- GET /api/farcaster/channels - Popular channels

## /api/gas
- GET /api/gas - Ethereum gas prices

## /api/lending/*
- GET /api/lending/aave - Aave lending
- GET /api/lending/compound - Compound lending
- GET /api/lending/morpho - Morpho lending
(+ 20 more protocols)

## /api/lens/*
- GET /api/lens/health - API status
- GET /api/lens/address/{address} - Profile by address
- GET /api/lens/accounts - Recent accounts

## /api/market/*
- GET /api/market/global - Global stats
- GET /api/market/trending - Trending tokens
- GET /api/market/movers - Top movers
- GET /api/market/fear-greed - Fear & Greed
- GET /api/market/dominance - BTC/ETH dominance

## /api/network/*
- GET /api/network/{chain}/status - Network status
- GET /api/network/status/all - All network status

## /api/nft/*
- GET /api/nft/collections - Top collections
- GET /api/nft/trending - Trending NFTs
- GET /api/nft/marketplaces - Marketplace volumes

## /api/perps/*
- GET /api/perps/list - Perps protocols
- GET /api/perps/gmx - GMX perps
- GET /api/perps/dydx - dYdX perps
- GET /api/perps/hyperliquid - Hyperliquid
(+ 15 more protocols)

## /api/price/*
- GET /api/price/{token} - Token price
- GET /api/price/batch - Batch prices
- GET /api/smart/price/{token} - Smart price
- GET /api/smart/prices - Multiple smart prices

## /api/protocols/*
- GET /api/protocols/{name} - Protocol full data
(900+ protocols supported)

## /api/safe/*
- GET /api/safe/info/{address} - Safe info
- GET /api/safe/balances/{address} - Safe balances
- GET /api/safe/transactions/{address} - Safe TXs
- GET /api/safe/pending/{address} - Pending TXs
- GET /api/safe/owners/{address} - Safe owners

## /api/stablecoins/*
- GET /api/stablecoins/marketcap - Total market cap
- GET /api/stablecoins/prices - All prices
- GET /api/usdc - USDC data
- GET /api/usdt - USDT data
- GET /api/dai - DAI data

## /api/staking/*
- GET /api/staking/lido - Lido staking
- GET /api/staking/rocket-pool - Rocket Pool
- GET /api/staking/eigenlayer - EigenLayer
(+ 15 more protocols)

## /api/wallet/*
- GET /api/wallet/balance/{address} - ETH balance

## /api/yields/*
- GET /api/yields/top - Top yields

---

*This comprehensive guide covers the Web3 Identity API. For real-time updates, see the OpenAPI spec at https://api.web3identity.com/openapi.json*